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PREFACE 


This manual describes how the RT-11 V5.4D operating system differs from RT-11 
V4.0, Wa.0, Vo.d, V5.2, V5.3, and V5.4. 


Changes made to RT-11 after the publication of the V5.4 RT-11 System Release 
Notes, AA-5286I-TC, and changes for V5.4A, V5.4B, V5.4C, and V5.4D are 
highlighted by change bars. In software version numbers, a whole number (XX) 
represents a major release and all its updates, and a mixed number (X.X) 
represents a major release or a specific update of a major release. For 
example, references to V5 apply to V5.4 as well, but references to V5.4 apply 
only to V5.4. Further, references to a letter update to V5.4 (for example 
V5.4D) apply to only that update release. 


If your RT-11 distribution is V5.4D, you have available all the functionality 
and software corrections described in this manual. As appropriate, this manual 
describes when that new functionality was added and those software corrections 
were made. 


Index entries for this manual are included in the new RT-11 on-line index 
program, INDEX, described in this manual. You can use INDEX to determine if 
information about a topic described in this manual is found elsewhere in the 
RT-11 documentation set. 


The system manager and system programmers should be thoroughly familiar with the 
contents of this manual before performing a system generation as described in 
the RI-11 System Generation Guide. 


This manual describes new features and corrected problems and presents a 
comparison between this release of RT-11 and the previous releases: 


@® Chapter 1 - NEW FEATURES 


This chapter describes the new processors, devices, software components, 
and documentation. 


e Chapter 2 - CHANGES AND ADDITIONS TO EXISTING COMPONENTS 


This chapter describes software components that have been improved 
through changed or added capabilities. 


@ Chapter 3 - RESTRICTIONS AND CORRECTED PROBLEMS 


This chapter describes software restrictions and documentation problems 
and lists software problems that have been corrected. 


Sus 


@ Chapter 4 - INSTALLATION, BOOTSTRAP, AND HARDWARE SETUP PROCEDURES 


This chapter tells you how to access on-line information that describes 
customizations you can use to improve system performance. The chapter 
also describes formatting, installation, bootstrap, and hardware setup 
procedures you may need depending on your configuration. 


® Chapter 5 - NATIVE TRANSFER UTILITY (Unsupported) 


This chapter tells you how to use the unsupported native TRANSFER 
utility. TRANSFER, released with RT-11 V5.3, copies files between a 
processor running RT-11 and another processor running RSX or VAX/VMS. 


@® Appendix A lists error messages for V5.3 and V5.4 with causes and 
solutions for each. Error messages for V5.4A through V5.4D are listed 
and described throughout this manual in the text that describes the 
condition that produces the error message. 


@ Appendix B explains the guidelines for submitting a software performance 
report (SPR) to DIGITAL. 


@ Appendix C describes how to use, with examples, the virtual memory (VM) 


device. This appendix has been generalized and expanded for RT-11 
V5.4D. Many processors can create a large enough VM device to run 
Boi... Running RT-11 from VM can greatly increase the performance of 


your processor. 


e Appendix D describes how to use, with examples, the logical disk (LD) 
subsetting utility. 


@® Appendix E describes how to use, with examples, the Single-Line (SL) 
command editor. 


@® Appendix F describes significant enhancements made to the backup utility 
(BUP} between V5.4 and V5.4D. 


NOTE 


A machine-readable addendum to this document, V5NOTE.TXT, is 
provided on the distribution kit. V5NOTE.TXT describes changes 
that have occurred since this document was printed. Index 
entries for information contained in V5NOTE.TXT are included in 
the on-line index program, INDEX. 


Information on unsupported utilities, previously in the file UNSUP.TXT, is now 
in Appendix C of the RT-11 System Utilities Manual. 


The term unsupported as used in reference to a distributed module means that 
DIGITAL does not guarantee that future releases will be necessarily compatible 
with previous versions of that module and does not guarantee that module will 
appear in future releases of RT-11. However, SPRs (Software Performance 
Reports) are answered for any module distributed with RT-11. 
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CHAPTER 1 


NEW FEATURES 


The primary goals of RT-11 V5 are to support additional processors and devices, 
improve and extend the functionality of software components, correct software 
problems, and increase the ease of RT-11 installation and maintenance. 

This chapter summarizes new hardware that RT-11 supports and its new software 
components. Refer to the rest of the manuals in the documentation set for 
detailed descriptions of how to use these new features. 


You can use the on-line index utility, INDEX, to find more information on topics 
described in this manual. 


1.1 PROCESSORS 


RT-11 V5 supports the following processors in addition to those already 
supported: 


T-11 Falcon (SBC-11/21 and SBC-11/21 PLUS) 
F-11 Microprocessor Based Board and Systems 
Professional 300 Series (PC325, PC350, and PC380) 


J-11 Microprocessor Based Boards and Systems 


1.1.1 T-11 Falcon (SBC-11/21 and SBC-11/21 PLUS) 
The T-11 processor chip is supported by the RT-11 single-job (SJ) and 
foreground/background (FB) monitors in the SBC-11/21 PLUS, single-board computer 


configuration. The original SBC-11/21 is also supported by the SJ and FB 
monitors. 


1.1.2 F-11 Microprocessor Based Board and Systems 


The PDP-11/23 PLUS is supported by RT-11 V5, including full 22-bit addressing 
(up to 4M bytes) under the extended memory (XM) monitor. 
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The PDP-11/23 PLUS processor is available in both the standard PDP-11/23 PLUS 
system configuration and in the MicroPDP-11/23 configuration. 


1.1.3 Professional 300 Series (PC325, PC350, and PC380) 

The Professional 300 series computers are supported by RT-11. Although the 
foreground/background (FB) monitor runs on Professional computers with some 
restrictions (see Chapter 3), the XM monitor is better suited for running RT-11 

on Professional computers. The XM monitor supports full RT-11 functionality, 
including 22-bit addressing, on Professional computers. The SJ and BL monitors 

are not supported on Professional 300 series computers. 

1.1.4 J-11 Microprocessor Based Boards and Systems 

RT-11 supports the J-1l microprocessor, including full 22-bit addressing (up to | | 
4M bytes) under the XM monitor. wo 


The KDJ11-A (J-11 CPU board) is a supported upgrade option to the PDP-11/23. 
Also supported are the MicroPDP-11/73 and MicroPDP-11/83 Q-bus processor systems 
and the PDP-11/84 UNIBUS processor system. 


RT-11 V5.4 supports the MicroPDP-11/53 (KDJ11-D) processor system. See Section 
1.2.4 for a description of the RX33 diskette drive. 


1.2 MASS STORAGE DEVICES 


RT-11 V5 supports the following mass storage devices in addition to those 
already supported: 


RA80/RA81 disks 

ROZS disk 

RD31/RD32/RD50/RD51/RD52/RD53/RD54 disks 

RX33/RX50 diskette a 
TK25 magtape 

TK50 magtape 

TSO5 (TSU05/TSV05) magtapes 

TU81+ magtape 


1.2.1 RA80/RA81 Disks (DU) 


RA80 


The RA80 disk is a 124M-byte fixed hard disk supported by the MSCP disk class 
handler, DU. 


Because the RA80 disk contains more than 64K blocks, it must be divided into 
multiple 64K-block partitions. When running under RT-1l, each partition Nuad 
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operates as a separate disk. Partition 0 can be used as a system volume or for 
data storage. All other partitions can be used for only data storage. 


The RA80 disk is supported for Q-bus processors, using the KDA50 controller. 


RA81 


The RA81 is a 406M-byte fixed hard disk. Because the RA81 contains more than 
64K blocks, it must be divided into multiple 64K-block partitions. Each 
partition operates as a separate disk. Partition 0 can be used as ae_e system 
volume or for data storage; all other partitions can be used for only data 
storage. You can divide the RA81 into a maximum of eight partitions. 
Therefore, at any given time you can directly address up to 262M bytes, using 
that method. You can use the JREAD and JWRITE subroutines to read and write 
data to the rest of the disk. 


The RA81 is supported for Q-bus and UNIBUS processors. 


1.2.2 RC25 Disk (DU) 


The RC25 disk is a 26M-byte disk supported by the MSCP handler, DU. RC25 disk 
drives are always paired. The even-numbered drive accepts a removable disk, and 
the odd-numbered drive contains a fixed RC25 disk for a total storage of 52M 
bytes per pair. RC25 disks can be used as the system volume or for data 
storage. 


1.2.3 RD31/RD32/RD50/RD51/RD52/RD53/RD54 Disks (DU or DW) 


The MicroPDP-11 can include a 10M-byte RD51 disk, a 20M-byte RD31 disk, a 
42M—-byte RD32 disk, a 33M-byte RD52 disk, a 71M-byte RD53 disk, or a 159M-byte 
RD54 disk. Each disk is an MSCP device supported by the MSCP disk class 
handler, DU. 


Because the RD32, RD53, and RD54 disks contain more than 64K blocks, they must 
be divided into multiple 64K-block partitions. Each partition operates as a 
separate disk. Partition 0 can be used as a system volume or for data storage. 
All other partitions can be used for only data storage. 


Professional 350 and Professional 380 systems can include a 5M-byte RD50 disk, a 
10M-byte RD51 disk, a 20M-byte RD31, support for approximately 32.5M-bytes on 
the RD32 disk, or a 33M-byte RD52 disk. The RD31, RD32, RD50, RD51, and RD52 
are supported by the DW handler. The RD53 and RD54 are not supported by the DW 
handler. 


RD31/RD32/RD50/RD51/RD52/RD53/RD54 disks can be used as system or data volumes. 
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1.2.4 RX33 Diskette Drive (DU) 


The RX33 1s a half-height diskette drive that supports RX33 double-sided 
1.2M-byte diskettes and RX50 single-sided 400K-byte diskettes. The RX33 
diskette drive 18 available only for Q-bus processors such as the MicroPDP-11 
and requires the RQDX3 controller. 


RX33 and RX50 diskettes are supported on the RX33 drive as both data and system 
media. For RT-11 V5.4A, you can perform the automatic installation procedure 
from RX50 distribution diskettes, using the RX33 diskette drive. See the R7-11 
Cover Letter for information. 


FORMAT Support 


For RT-11 V5.4A, FORMAT supports formatting the RX33 diskette. Formatting RX33 
diskettes requires an RX33 diskette drive and an RQDX3 controller of at least 
microcode revision 2. 


If you attempt to format an RX33 diskette and your DU controller is not an 
RQDX3, FORMAT returns the error message, ?FORMAT-F-Device invalid or not 
Supported by FORMAT. If you attempt to format an RX33 diskette and your RQDX3 
controller is below microcode revision 2, FORMAT returns the error message, 
?FORMAT-F-Operation unsupported on old micro-code revision. Contact your local 
DIGITAL field service representative to update your RQDX3 controller. 


The RQDX3 controller is locked during the formatting and is unavailable to any 
other device on that controller. Therefore, you cannot perform I/O to any other 
device on that controller while you are formatting an RX33 diskette. 


If you attempt to format an RX50 diskette in an RX33 diskette drive, FORMAT 
returns the query, ddn: is an RX50 volume/FORMAT-Are you sure? Do not format 
Single-sided quad-density RX50 diskettes in the RX33 diskette drive. You can 
format double-sided high-density diskettes previously formatted as RX50s in the 
RX33 diskette drive. 


RX33 and RX50 diskettes are physically similar. Use the color of the metal 
diskette oxide surface to distinguish them from each other. RX33 diskettes have 
a black oxide surface, while the surface of the RX50 diskette is brown. The 
difference 1s apparent when you compare them. 


CAUTION 
DO NOT FORMAT RX50 DISKETTES IN THE RX33 DRIVE 


It is physically possible to format RX50 diskettes as RX33 
diskettes. However, RX50 diskettes do not contain the same 
oxide (storage medium) as RX33 diskettes and therefore cannot 
safely store 1.2M bytes of data. RX50 diskettes therefore can 
randomly lose data if they are formatted as RX33 diskettes. 
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1.2.5 RX50 Diskette (DU or DZ) 


The RX50 is a diskette subsystem available on Q-bus processors such as_ the 
MicroPDP-11, UNIBUS processors, and Professional 300 series processors. The 
subsystem consists of two drives, each of which holds one 5 1/4-inch diskette. 
Each diskette provides a storage capacity of 400K bytes (800 blocks). 


RX50 diskettes on the Q-bus processors are MSCP (mass storage communication 
protocol) devices supported by the MSCP disk class handler, DU. On Professional 
300 series processors, RX50 diskette drives are supported by the DZ handler. 
MicroPDP-11 and Professional computers can read and write each other’s 
diskettes. However, since they are supported by different device handlers, a 
diskette configured to bootstrap on one cannot be hardware bootstrapped on the 
other. 


RX50 diskettes can be used as system or data storage volumes. The RT-11 V5 
distribution kit is available on RX50 diskettes. 


1.2.6 TK25 Magtape (MS) 


The TK25 is a streaming TSll-compatible cartridge magtape drive, operating on 
the Q-bus. Data is recorded on a 600-foot, 10-track (1/4-inch format) magtape. 
The TK25 stores up to 60M bytes of data in 8K-byte blocks, with a record size of 
up to 16K bytes. The read/write speed is 55 in/second while streaming, for a 
data transfer rate of 55K bytes/second. 


1.2.7 TK50 Magtape (MU) 
RT-11 V5.4 supports TK50 magtape. 


The TK50 is a cartridge tape drive that uses the tape-class mass storage 
communication protocol (TMSCP). The TK50 stores approximately 95M bytes of data 
(unformatted) on 600 feet of 1/2-inch magtape at a density of 6667 bits/inch. 
The tape contains 22 tracks. 


The RT-11 V5.4 distribution kit is available on TK50 magtape. You can install 
RT-11 from the TK50 magtape, using the Automatic Installation Procedure. See 
Section 1.5.1 for information. 


You can boot RT-11 only from TK50 magtape controller unit 0. You must install 
TK50 magtape controller unit 0 (MU0) at CSR address 774500 and at VECTOR 260. 


The RT-11 V5.4 program, MSCPCK.SAV, checks the TQK50 Q-bus controller for its 
rev level. If the TOK50 controller is below rev level, the MU handler installs 
and MSCPCK.SAV returns the error message, ?MSCPCK-W-TQK50 controller below FW 
Rev 4/HW Rev 6. If you receive that message, contact your local DIGITAL field 
service representative. Reliable TK50 operation on Q-bus processors requires a 
controller of at least firmware revision 4 and hardware revision 6. 
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1.2.8 TSO5 (TSU05/TSV05) Magtapes (MS) 


The TSO5 is a TSll-compatible tape drive. The TSU05 runs on UNIBUS processors, 
the TSVO5 on Q-bus processors. 


Data is recorded on a 9-track 1/2-inch format magtape. The TSO5 can store up to 
28M bytes (in formatted 2K records) on a standard 10 1/2-inch, 2400-foot reel of 
tape. TSO5 tape drives can accept three tape reel sizes: 7 inch, 8-1/2 inch, 
and 10-1/2 inch. 


The TSO05 is a streaming tape drive that operates in two modes: TS11 compatible 
mode and extended features mode. In TS11 mode, the TSO05 is a TS11 look-alike 
that runs at 25 in/s. In extended features mode, which is turned on by setting 


the hardware extended features switch, the tape can stream at 100 in/s under 
program control. 


1.2.9 TU81+ Magtape (MU) 


RT-11 V5.4C supports the TU81+ magtape device as a data and backup device. 


1.2.10 Vv7r300 Series Terminals 


RT-11 V5.4C supports the VT300 series terminals in the same manner as_ the 
current support for the VT102 video terminal. 


1.3 OTHER NEW HARDWARE SUPPORT 


RT-11 supports the following new hardware. 


1.3.1 Global Region Base Address Support and Cache-bypass Support 


RT-11 for V5.4A provides the capability of specifying the base address for a 
global region. Section 2.39 describes the changes to the .RDBBK macro that 
enable this support. This section describes using that functionality to support 
cache-bypass for processors that share memory. 


RT-11 contains the following support for cache-bypass. 


@® RT-11 V5.4A includes cache-bypass functionality for processors that 
share memory. Use the cache-bypass functionality to ensure that data 
read from shared memory is read from that shared memory and not the 
processor’s hardware memory cache. Using the cache-bypass functionality 
does not eliminate use of the processor hardware memory cache for areas 
not marked as cache-bypass. 


Use the following information to enable the cache-bypass functionality: 
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Only global regions can possess the cache-bypass attribute. 
Therefore, you must assign all or a portion of your shared memory to 
a global region. Any local region attached to a global region shares 
the cache-bypass attribute of that global region. Any local region 
not attached to a global region has cache-bypass set off. 


The following bit definitions are new and control the cache-bypass 
attributes of a global region: 


Symbol Value Location and Meaning When Set 


BS.CAC 100 Bit 6 of R.GSTS (byte offset 4 of region 
definition block). Enable cache-bypass. 

RS .BAS 40 Bit 5 of R.GSTS (byte offset 4 of region 
definition block). Explicitly assign base 


address for this global region. 


RS.NSM 20 Bit 4 of R.GSTS (byte offset 4 of region 
definition block). Explicitly assign base 
address for this global region above system 
memory. 


System memory is defined as the I/O page and that 
memory below the address you derive from the 
value stored in RMON fixed offset 420, SMEMSZ. 


GR.CAC 20 Bit 4 of GR.STA (byte offset 4 of global region 
control block) . Cache-bypass is enabled for 
global region. 


R.CACH- 10 Bit 3 of R.BSTA (byte offset 4 of region control 
block) . Local region is attached to a global 
region with cache-bypass set. 


The following information describes the use of those bits to enable 
cache-bypass: 


Use the new base=n parameter in the .RDBBK macro to assign the shared 
memory global region base address at each processor to the same 
value. Using the base=n parameter (with n nonzero) also sets RS.BAS 
in the region status word (R.GSTS). If that shared memory region 
resides above system memory, you must also specify RS.NSM in the 
rgsta parameter of .RDBBK. See Section 2.39 for more information on 
using the .RDBBK macro base=n parameter. 


Specify RS.CAC in the rgsta parameter of .RDBBK. Specifying RS.CAC 
causes GR.CAC in the global region control block to be set when the 
global region is created using the .CRRG request; otherwise, GR.CAC 
is cleared. 
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When .CRRG is processed, R.CACH is initially cleared. Tf .CRRG 2s 
for attachment to or creation of a global region, GR.CAC is copied to 
R.CACH. 


Mapping operations (.MAP request or the .CRAW request with WS.MAP 
specified) set bit 15 in all PDRs used to map the region that has 
cache-bypass enabled. 


See Chapter 4 of the RT-11 Software Support Manual for information on 
global regions. 


® The following program fragment illustrates the code necessary to use 
cache-bypass. It attaches a local region to a global region named 
SHARED with a size of 20000 bytes and a base address of 1000000. The 
Size and base in the fragment are expressed in 32 (decimal) -word 
blocks. The rgsta parameter RS.CGR creates the global region SHARED 
if it is not already resident in memory. The rgsta parameter RS.CAC 
causes caching to be bypassed for all mapped windows using this 
region. You should perform a similar operation, using the same 
values and symbols for any processor using this shared memory: 


AREA: .BLKW 2 
RDB: .RDBBK RGSIZ=200,RGSTA=<RS.GBL!RS.CGR!RS.CAC>, 
NAME=SHARED, BASE=10000 


.CRRG  #AREA, #RDB 


1.3.2 PRO Expander 


The PRO Expander lets you add one additional RD5x controller and hard disk to a 
Professional series processor configuration. RT-11 V5.4 supports the PRO 
Expander in the following manner. 


The DW handler supports only a single device connected to a single controller. 
Therefore, to support the second controller and hard disk, you must COPY the DW 
handler to another handler name (for example, DV) and use a SET command to 
assign the created handler (DV) to the second device. 


COPY the DW handler to DV and use the SET DV SLOT=n command to support the PRO 
Expander. (Using device name DV is optional; you can use any device name not 
recognized by or assigned to RT-11.) Use the SLOT=n option only to support a PRO 
Expander and only with the created handler. 


Use the SLOT=n option to identify the PRO Expander RD5x controller card slot in 
the Professional’s backplane. The six card slots are numbered 0 through 5, from 
front to back. The first RD5x controller is typically in slot 0. The second 
RDSx controller typically goes in slot 5. Assuming that arrangement, issue the 
following commands to support the PRO Expander: 
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«COPY SY:DW([X].SYS DV[X] .SXs 
.SET DV SLOT=5 
. INSTALL DV 


The SLOT=n option and created handler as support for the PRO Expander are an 


interim solution. A simpler solution may be supplied in a future release. Do 
not rely on the SLOT=n option being present in future releases of RT-11. 


1.3.3 512K-Byte Memory Expansion Card 
The 512K-byte memory expansion card is supported for Professional series 


processors. It adds 512K bytes to the on-board memory and can give the 
processor up to 1024K bytes of memory. 


1.3.4 LA75 Printer 
For RT-11 V5.4, the LA75 printer is supported in the same manner as current LA50 


printer support. That is, the LA75 responds to the same (and only) SET 
conditions and SETUP modes as an LA5O. 


1.3.5 LG0O1 and LGO2 Printers 

RT-11 V5.4B supports the new LGO1 and LGO2 dot-matrix printers. Certain uniform 
and nonuniform SETUP modes are supported on the LGO1 and LGO2 printers. Uniform 
and nonuniform SETUP modes for the LGO1 and LGO2 are listed in Section 4.5.1 of 
this manual and described in Chapter 7 of the RT-11 System User’s Guide. 


Section 4.5.3 lists the minimal SET conditionals that DIGITAL recommends you use 
with the LGO1 and LGO2 printers. 


1.3.6 LJ250 Printer 

RT-11 V5.4D supports the new LJ250 dot-matrix printer. 

Certain uniform and nonuniform SETUP modes are supported on the LJ250 printer. 
Uniform and nonuniform SETUP modes for the LJ250 are listed in Section 4.5.1 of 


this manual and described in Chapter 7 of the RT-11 System User’s Guide. 


Section 4.5.3 lists the minimal SET conditionals that DIGITAL recommends you use 
with the LJ250 printer. 


1.3.7 Mini-Exchange 
The Mini-Exchange is a serial switching box that allows up to eight ports to be 


controlled by character string commands. RT-11 does not support printers on the 
Mini-Exchange. 
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See the RT-11 System Utilities Manual for information on using the Mini-Exchange 
with the virtual terminal communication utility (VTCOM). 


1.4 DISTRIBUTION KITS 
The format of RT-11 distribution kits has changed in Version 5 because of the 
automatic installation and verification procedure (see Section 1.5.1). The 


procedures for RT-11 V5 distribution kits that will not be installed 
automatically are in Chapter 4. 


1.5 NEW SOFTWARE COMPONENTS 


Although RT-11 V5’s primary goal is to extend the functionality of existing 
software, V5 also includes the following operating features: 


e Automatic installation (AI) and installation verification procedure 
(IVP) 


® Backup utility program (BUP) 

@e Concise command language (CCL) 

@ Ethernet controller hardware handlers (NC/NQ/NU) 
@ Global region support in extended memory 

® Graphics utility support (PRO/GIDIS) 

@e Indirect control file processor (IND) 

@® On-line index program (INDEX) 

@® Virtual KED (KEX) 

@® Logical disk subsetting handler (LD) 

e Hardware setup utility (SETUP) 

@ Single-line editor (SL) 

@ Transparent spooling utility (SPOOL) 

@® Native transfer utility (TRANSFER) (unsupported) 
@e User commands first utility support (UCF) 

@ User command linkage utility (UCL) 

@ Virtual RUN utility (VBGEXE) (unsupported) 

® Virtual terminal communication package (VTCOM) 


In addition, RT-11 V5 includes additional programmed requests, macros, SYSLIB 
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routines, handlers, error messages, system generation procedures and options, a 
new software update process, and new unsupported utilities. The following 
sections summarize those components and refer you to more detailed descriptions 
in the documentation set. 


1.5.1 Automatic Installation and Verification Procedure 


The RT-11 V5 automatic installation and verification procedure installs RT-11 by 
conducting an interactive dialog at the console terminal. As you answer the 
dialog questions, the system creates and exercises a working RT-11 system. 


The following hardware configuration is required for the automatic installation 
procedure: 


@ PDP-11 processor with 24K words of memory or Professional 300 series 
computer (TK50 magtape automatic installation requires 256K bytes of 
memory) 


e A line or Professional clock 


@e VT100 series, VT200 series, VT300 series, or ULA100 series console 
terminal or a Professional 300 series system 


@ One of the following mass storage configurations: 


MicroPDP-11 (RX33/RX50/RD31/RD32/RD51/RD52/RD53/RD54) - 
distribution kit resides on RX50  4diskettes. Automatic 
installation using RX50 diskettes requires using the RX33 or RX50 
diskette drive 


Professional 350 or 380 - distribution kit resides on RX50 
diskettes 


TK50 magtape - distribution kit resides on TK50 magtape 
Dual RLO2 disks - distribution kit resides on RLO2 disk 
Dual RX02 diskettes - distribution kit resides on RX02 diskettes 


If you bought an RT-11 distribution kit on any of those media, you either 
received an RYJ-11 Automatic Installation Booklet, which tells you how to start 
the automatic installation process, or you can find that information in the 
cover letter shipped with your distribution. If your configuration does not 
meet the requirements shown above, have DIGITAL install your system or you 
install your system by following the procedures described in the ARf-11 
Installation Guide. 


1.5.1.1 RX02 and RX50 Automatic Installation Information - RX02 and RX50 
distribution kits include two copies of the RT-11 distributed software, so you 
do not have to back up the distribution kit. Although not supported for the 
automatic installation procedure, RX01 distribution kits also include two copies 
of the distributed software. 
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Store one copy as your master distribution kit and bootstrap the other copy to 
run the automatic installation procedure. Be careful to keep the volumes from 
those two (RX02 or RX50) distribution kits separate. Once the installation 
procedure has been run, volumes AUTO and 1 of the distribution kit you installed 
will no longer be identical to volumes AUTO and 1 of the master distribution kit 
you stored. 


1.5.1.2 RLO2 Automatic Installation Information - For RLO02 distribution, the 
only difference between the original distribution volume you received and the 
installed volume is the bootstrap. The bootstrap on the original distribution 
kit bootstraps the automatic installation monitor, RT11AI.SYS. The bootstrap on 
your installed system bootstraps the RT-11 FB monitor, RTI11FB.SYS. Therefore, 
you can return your installed system to its original state by copying the 
RT11AI.SYS bootstrap to the boot blocks of your disk. 


1.5.1.3 TK50 Automatic Installation Information - Automatic installation using 
the TK50 magtape distribution requires at least 256K bytes of memory and an 
installed MU boot ROM. You can boot RT-11 only from TK50 magtape controller 
Unit 0. You must install TK50 magtape controller unit 0 (MUO) at CSR address 
774500 and at VECTOR 260. 


See Chapter 4 for procedures for RT-11 V5 distribution kits that do not support 
automatic installation. 


1.5.2 New System Procedures and Utilities 


This section describes the system procedures and utilities provided with RT-11 
Ve. 


1.5.2.1 Backup Utility Program (BUP) - The backup utility program provides a 
quick way to store a large volume or file on a set of smaller volumes. 


BUP lets you copy a large volume or file to several specially initialized backup 
volumes. The file or volume cannot be used, however, while stored on the backup 
volumes. BUP also lets you initialize backup volumes, obtain directory 
information about a set of backup volumes, and restore a volume or file to its 
Original form from a set of backup volumes. In addition, BUP will use the 100 
in/sec streaming mode of the TSO05 magtape drive under the SJ and FB monitors. 


Appendix F and Chapter 2 contain information about significant new BUP 
functionality. 


see Chapter 3 in the RT-11 System Utilities Manual for additional information on 
BUP. Use the new on-line index, INDEX, to find the latest information about 
topics related to BUP and BACKUP. 
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1.5.2.2 Concise Command Language (CCL) - Concise command language lets you 
issue commands directly to utility programs or your own user-written programs on 
a single command line. 


Prior to RT-11 V5, you could issue commands on a single command line only by 
using DCL keyboard monitor commands or by running (R or RUN) the program and 
specifying a CSI command line. CCL lets you run the program and specify the 
input and output files and all accompanying options on a single line. 


See the RT-11 System User’s Guide for more information on CCL. Use the new 
on-line index, INDEX, to find the latest information about topics related to 
Lis 


1.5.2.3 DBG-11 Symbolic Debugging Package (Unsupported) - DBG-11 is a_ symbolic 
debugging package that lets you interactively debug a MACRO-11 program. You can 
use DBG-11 to: 


e Control program execution through breakpoint traps and single-step 
execution of instructions. 


@ Display the contents of locations in numeric or symbolic form. 
e Change the contents of locations. 
e Define symbolic names for memory addresses and location values. 


The unsupported DBG-11 package consists of four pseudodevice handlers (SDH.SYS, 
SDHX.SYS, SDS.SYS, and SDSX.SYS) and DBGSYM.SAV, a symbol definition utility. 
The DBG-11 Symbolic Debugger User’s Guide tells you how to use DBG-11 under 
RT-11. Also see the DBG-11 restrictions section in Chapter 3. 


1.5.2.4 Ethernet Controller Hardware Support - The Ethernet handlers provide 
hardware support for Ethernet class controllers. 


e The NC handler supports the DECNA Ethernet controller for the 
Professional 300 series processors. 


e The NQ handler supports the DEQNA Ethernet controller for Q-bus 
processors. 


@e The NU handler supports the DEUNA and DELUA Ethernet controllers for 
UNIBUS processors. 


Ethernet handlers run only under the XM monitor. Each handler supports only one 
controller. An unsupported program, NITEST.MAC, is included with your 
distribution kit; use NITEST.MAC to verify connection to the Ethernet. 


For information on the Ethernet handlers NC and NQ, see the RT-11 Software 
Support Manual. All information describing NC and NQ also applies to the NU 
handler. For information on building and running the unsupported program 
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NITEST.MAC, see the RT-11 System Utilities Manual. Use the new on-line index, 
INDEX, to find the latest information about topics related to Ethernet handler 
SUPpOrt. 


1.5.2.5 Global Region Support in Extended Memory - Global regions are areas of 
extended memory that are controlled by the operating system, rather than by a 
particular program. Global regions can be used by more than one program and can 
remain in extended memory after the creating program has exited. User programs, 
system utilities, system device handlers, and monitors can create global 
regions. You can create up to ten global regions, and a program can attach to a 
combination of up to six local or global regions. 


Creating, attaching to, detaching from, and eliminating global regions are 
controlled by programmed requests in the same manner as regions local to a 
program. For complete information on global region support, see the AT7-11 
Software Support Manual. Use the new on-line index, INDEX, to find the latest 
information about topics related to global region support. 


1.5.2.6 Graphics Utility Support (PRO/GIDIS) - The graphics utility PRO/GIDIS 
is a foreground job for Professional 300 series processors. PRO/GIDIS runs 
under the XM monitor and requires FPU (floating-point unit) hardware and the 
extended bit-map option (EBO). PRO/GIDIS lets you create applications in which 
images are described using geometrical entities such as lines, arcs, and shaded 
areas. 


PRO/GIDIS support is provided by the Professional interface handler (PIX.SYS) 
and the foreground program GIDIS.SAV. RT-11 provides three interfaces between 
the applications program and the Professional interface handler: 

@e The .SPFUN programmed request 

@® The GIDCAL system subroutines 

@e The ISPFN/ISPFNC/ISPFNF/ISPFNW system subroutines 
See the RT-11 System Programmer’s Manual for complete details on running 


PRO/GIDIS under RT-11. Use the new on-line index, INDEX, to find the latest 
information about topics related to PRO/GIDIS support. 


1.5.2.7 Indirect Control File Processor (IND) - The indirect control file 


processor executes indirect control files. IND control files contain IND 
directives, which control the execution of the indirect control file, and may 
contain keyboard commands (DCL, CCL, and UCL). You can use indirect control 
files to access other files, execute keyboard monitor commands, define symbols, 
pass parameters, and perform logical tests. 


When running under the XM monitor, IND stores context information in a region of 
high memory, resulting in a performance improvement. 
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KMON is the default command file processor in the distributed monitors. If you 
want to change the default command file processor to IND, use the monitor 
command SET KMON IND or apply the customization given in the R7-1l1 Installation 
Guide. 


Chapter 5 in the RT-11 System User’s Guide describes how to create and execute 
indirect control files. Use the new on-line index, INDEX, to find the latest 
information about topics related to IND support. 


1.5.2.8 ‘Virtual KED (KEX) - The virtual KED program (KEX) is the default editor 
under the XM monitor and is used only under the XM monitor. KEX can be run as a 
foreground or system job, allowing editing to continue while the system is 
performing other functions. 


KEX editing commands are identical to KED commands. However, KEX minimizes the 
amount of low memory used. Therefore, KEX will continue to operate in many 
instances where there is insufficient low memory for KED to run. You also 
maximize the size of paste buffers when you use KEX; you have more memory 
available for them. 


You can create multiple copies of KEX by running KEX as a system job and 
assigning KEX1, KEX2, or KEXn as logical job names to KEX. For example, the 


following series of commands creates two KEX editors, KEX and KEX1, and runs 
them as system jobs: | 


. SRUN KEX.SAV/NAME:KEX <RET> 

. SRUN KEX.SAV/NAME:KEX1 <RET> 
That procedure can be useful, for example, in examining the contents of one 
file, using KEX, while you are editing another file, using KEX1. You can also 


edit both files concurrently. 


Assuming you have created and are running two KEX editors, use the following 
procedure to examine and/or edit two files concurrently: 


@® Open the first file (filel.ext), using KEX. Type CTRL/X and specify KEX 
in response to the system job prompt. Specify filel.ext in response to 
the KEX prompt. 


JOB>KEX <RET> 
*filel.ext <RET> 


The contents of filel.ext appear on your terminal screen. 

e Open the second file (file2.ext), using KEX1. Type CTRL/X and specify 
KEX1 in response to the system job prompt. Specify file2.ext in 
response to the KEX1 prompt. 


JOB>KEX1 <RET> 
*file2.ext <RET> 


The contents of file2.ext appear on your terminal screen. 
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@® You can now return to filel.ext, using the following three steps: 
1. Type CTRL/X. 
2. Type KEX in response to the system job prompt and press RETURN. 


3. Type CTRL/W to repaint your terminal screen with the contents of 
filel.ext. 


@ You can use that procedure to go from one file to the other. Simply 
type CTRL/X, specify which editor you want to use, and use CTRL/W to 
repaint your screen. The cursor position in one file does not change 
because of editing you are doing in the other file. The editors are 
independent. 


@ You use the same KED commands and operations when you use multiple KEX 
editors. 


@ Because you are running one or more KEX editors as system jobs, you 
Still have access to the monitor prompt, using CTRL/B. 


@® When you want to remove an editor from memory, type CTRL/C in response 
to that editor’s prompt (*). 


The number of KEX editors you can run as system jobs is limited only by 
available memory or the 8-job limit of RT-11. 


On systems that include multiterminal support, multiple copies of KEX can be run 
(using the SRUN and FRUN commands), each from its own terminal. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to KEX support. 


1.5.2.9 Logical Disk Subsetting Handler (LD) - The logical disk subsetting 
handler lets you define logical disks, which are subsets of physical disks. You 
define logical disks by assigning a logical disk unit number to a file on a 
physical disk. You can then use the logical disk as though it were a physical 
disk. 


Appendix D contains complete information on using logical disks. 


Chapter 9 in the R7-11 System Utilities Manual further describes the LD utility. 
Use the new on-line index, INDEX, to find the latest information about topics 
related to LD support. 


1.5.2.10 Hardware Setup Utility (SETUP) - The SETUP utility lets you choose 
operating characteristics for video terminals, printers, and some system clocks. 
By typing SETUP commands, you can control terminal characteristics such as 
background and text color, scrolling, and cursor form (block or underscore); 
printer characteristics such as length of printed pages; and clock 
characteristics such as the 12- or 24-hour time reporting format. 
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SETUP’s video characteristics are intended primarily for use with Professional 
300 series computers, since they have no hardware terminal setup facility. 
However, many SETUP commands are also valid for VT100 and VT200 series 
terminals. Some commands are valid for only VT100 series terminals. 


See the RT-11 System User’s Guide for details on how to use SETUP and for a list 
of SETUP commands. See Section 4.5.1 for a table of SETUP modes and controls 
for specific line printers. Use the new on-line index, INDEX, to find the 
latest information about topics related to SETUP support. 


1.5.2.11 Single-Line Command Editor (SL) - The single-line command editor (SL) 
lets you edit the current keyboard command line typed on a video terminal before 
you terminate the line. 


Appendix E contains information on using SL. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to SL support. 


1.5.2.12 Transparent Spooling Package (SPOOL) - The transparent spooler (SPOOL) 
sends output to the line printer. SPOOL runs as a foreground or system job. 
Once SPOOL is running, its operations are transparent. Anytime you send output 
to the line printer, either explicitly by issuing commands (such as COPY and 
PRINT) or by using commands and options that send output to the line printer by 
default (such as COMPILE/LIST), SPOOL accepts the output and sends it to the 
printer. While SPOOL runs in the foreground, you can continue to work on other 
jobs in the background. SPOOL differs from the Queue Package in that you need 
not send output to SPOOL as a complete file. Instead, SPOOL accepts output as 
it becomes available ("pipeline" operation). 


Although the line printer is SPOOL’s default output device, you can apply a 
software customization to change the default. 


See the RT-11 System Utilities Manual for an explanation of how to use SPOOL. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to SPOOL support. 


1.5.2.13 Native RSX and VMS Transfer Utility (TRANSF.TSK and TRANSF.EXE) - 
TRANSF.TSK and TRANSF.EXE let you copy files between your RT-11 stand-alone 
system and a PDP-11 processor running RSX or a VAX processor running VMS. No 
intermediary such as RTEM is required. TRANSF is an unsupported utility. 
Information on using TRANSF is in Chapter 5. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to TRANSF support. 
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1.5.2.14 User Commands First Feature (UCF) - UCF lets you write your own 
command preprocessing utility that intercepts any command line input before KMON 
attempts DCL, CCL, or UCL parsing. UCF lets you process valid DCL commands in a 
way you choose, rather than the way KMON would normally process the commands. 
UCF can intercept and process commands that KMON would treat as invalid. 


The distributed file UCL.SAV (user command linkage utility) can be copied and 
renamed to create a functioning UCF utility. 


Command line input can originate from direct console input, a command file, a 
command line in the chain area from an exiting program, a BATCH file, or IND. 
UCF can: 


@® Receive a command line and return it unaltered to KMON for processing. 


e® Receive a command line with syntax not recognized as valid by KMON and 
convert the command line to KMON-valid command syntax. 


® Intercept and destroy a command you do not want executed. 


@® Send escape sequences in response to immediate commands, such as CLEAR 
SCREEN. 


See the RT-11 System User’s Guide for information on using UCF.SAV. Use the new 
on-line index, INDEX, to find the latest information about topics related to UCF 
SUPPOIt. 


1.5.2.15 User Command Linkage Feature (UCL) - User command linkage (UCL) lets 
you write your own command parser, so you can create your own commands. 


See the RT-11 System User’s Guide for instructions on how to define commands. 
See the RI-11 Software Support Manual for more information on UCL. Use the new 
on-line index, INDEX, to find the latest information about topics related to UCL 
Support. 


1.5.2.16 Virtual RUN Utility (VBGEXE) - VBGEXE lets you run some programs under 
the XM monitor when there is not enough low memory to run the program by using 
the R or RUN command. VBGEXE is especially useful for running programs on a 
Professional 300 series computer under the XM monitor. 


Some restrictions apply when using VBGEXE, and it is an unsupported utility. 
See the RT-11 System Utilities Manual for information on using VBGEXE.SAV. Use 
the new on-line index, INDEX, to find the latest information about topics 
related to VBGEXE support. 
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1.5.2.17 Virtual Terminal Communication Package (VITCOM) - VTCOM lets you use 
your local PDP-11, PDT-11/150, or Professional computer as a terminal when you 
connect your local computer to a host computer. VTICOM.REL runs under the SJ and 
FB monitors. VTCOM.SAV, which runs under the XM monitor, minimizes the amount 
of low memory used, so more low memory is available for other programs. 


When running VICOM, you can access facilities on an RT-11, RSX-11, RTEM-11, or 
VAX/VMS host system, and perform ASCII file transfers between the host computer 
and your stand-alone system. In addition, if the host computer is running RSX 
or VAX/VMS and TRANSF.TSK or TRANSF.EXE is installed on the host, you can 
transfer binary files as well. Since VTCOM can run as a foreground or system 
job, you can continue working under RT-11 while you maintain connection to the 
host computer. | 


The RT-11 System Utilities Manual lists requirements for running VTCOM and 
explains how to use VTCOM. Chapter 5 shows how to run TRANSF.TSK and 
TRANSF.EXE. Use the new on-line index, INDEX, to find the latest information 
about topics related to VICOM support. 


1.5.3 New Programmed Requests 


This section describes the programmed requests available with RT-11 V5. The 
programmed requests are located in SYSMAC.SML. 


1.5.3.1  .ABTIO - The .ABTIO programmed request lets a running job stop all 
outstanding I/O operations on a specified channel without terminating the 
program under the FB and XM monitors. Under SJ, the request is simulated with a 
.WAIT directive. 


See the RT-11 Programmer’s Reference Manual for details and examples of the 
-ABTIO programmed request. Use the new on-line index, INDEX, to find the latest 
information about topics related to .ABTIO support. 


1.5.3.2  .-ADDR - The .ADDR macro computes the address of the location you 
specify in a position-independent manner (independent of its link-time virtual 
address) and stores that address in a register or on the stack. 


See the RT-1l Programmer’s Reference Manual for more information on the .ADDR 
macro. Use the new on-line index, INDEX, to find the latest information about 
topics related to .ADDR support. 


1.5.3.3 ASSUME - The .ASSUME macro tests, at assembly time, the validity of a 
condition you specify. If the test is false, MACRO generates an assembly error 
and prints a message from a comment you supply as an argument to the macro. 


See the RT-11 Programmer’s Reference Manual for more information on the .ASSUME 
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macro. Use the new on-line index, INDEX, to find the latest information about 
topics related to .ASSUME support. 


1.5.3.4 .BR- The .BR macro warns you if code that belongs together is 
separated during assembly. When you call the .BR macro, you specify a location 
aS an argument. .BR checks that the address of the next instruction matches the 
address of the location you specified. If the addresses do not match, .BR 
causes MACRO to print an error message. 


See the RT-11 Programmer’s Reference Manual for more information on the .BR 
macro. Use the new on-line index, INDEX, to find the latest information about 
topics related to .BR support. 


1.5.3.5 .CKXX - The .CKXX macro generates CK.Rn register checking macros. You 
specify a register as an argument to .CKXX, and .CKXX creates the CK.Rn checking 
macro for that register. More than one register can be specified for .CKXX, 
creating a CK.Rn checking macro for each register. More than one CK.Rn checking 
macro can be created for a particular register. 


Use the CK.Rn macro to simplify the checking of assumptions about registers when 
those registers are used in autoincrement and autodecrement mode instructions. 
You can also assign symbols to CK.Rn that can be used to store register contents 
during autoincrement and autodecrement operations. Those symbols can later be 
used to verify the position of the stored values. 
Macro Call: .CKXX <reg[,reg,...]> 
where: 
reg is the register or registers you want .CKXX to define as _ check 
registers. Calling .CKXX generates a CK.Rn check macro for each 
register you include in the reg argument. For example, the macro 
Cail 
.CKXX <RQ> 
generates the check macro CK.RO. The macro call: 
Ce <R0Ri> 
generates the check macros CK.RO and CK.RI1. If you want to 
generate more than one check macro for a single register, for 
example Rl, append a different letter to the register number for 
each check macro you want to create. For example: 
.CKXX <R1A,R1B> 
generates the check macros CK.RIA and CK.RIB. 


The check macro CK.Rn, generated by .CKXX, has the following form: 
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CK.Rn[alph] [label] [,change] [,result] 
where: 
n is the register that .CKXX assigned to this check macro 


alph is an alphabetic character that .CKXX assigned to this check 
macro 


label is the value or label you assume equates to the check register. 
If the value or label does not equate to the check register, a P 
(phase) error is returned at assembly time. See the PDP-1l1 
MACRO-11 Language Reference Manual, Appendix D, for a description 
of the P assembly error 


change indicates the check macro increment or decrement. The change 
value must be preceded by a plus sign (+) to indicate increment 
or a minus sign (-) to indicate decrement. When the change is an 
increment, any assumption is checked first and the check macro is 
then incremented. When the change is a decrement, the check 
macro is first decremented and then any assumption is checked 


result is a new location assigned to the check macro. Use the result 
argument to assign a symbol to the check macro. When you want to 
verify (further in your program) that the check macro equates to 
that symbol, specify that symbol in the label argument 
The check macro for a register must exactly track the operations done on that 
register. The check macro for a register must be explicitly incremented or 
decremented if that register is incremented or decremented. Refer to the 
following program fragment example. 
Example: 
This example illustrates the following check macro features: 
e Assigning an initial value to the check macro 


@e Transferring a value from one check macro to another 


@ Checking the current value of a register pointer and tracking for 
autoincrement 


® Tracking for autodecrement and then checking the current value of a 
register pointer (decrement performed first) 


e® Tracking for autoincrement and autodecrement without checking for values 


For the purpose of this example, assume the following data block: 


DBLK: . BLKW 4 
DEV=: 0 
NAME=: 2 
TYPE=: 6 
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.MCall .CKXX + Call ~CRX 
.CKXX  <R3,R4> ; create CK.R3 and CR.R4 
MOV #DBLK, R3 ; point to data block DBLK 
CK.R3=DEV ; aSSign initial value to check macro 
MOV R3,R4 ; copy the pointer 
CK.R4=CK.R3 ; copy the check macro to new one 
CK.RS DEV, TZ ; check R3 equates to DEV 
> and increment 
MOV (R3)+,R0 ; load device name into RO 
CK.R3 NAME,+2 ; check R3 equates to NAME 
; and increment 
MOV (R3) +, NAME+0 ; get first part of file name 
GR RO pre ; increment but no check (no label) 
MOV (R3) +,NAME+2 ; get last part of file name 
CKhRS IXPE ; check R3 equates to TYPE 
; but no increment 
MOV @R3,R2 ; filespec extension into R2 
CKRS NAMETZy=2 ; decrement and check R3 equates 
; to NAME+2 
TS. - (R3) ; test last 3 chars of filespec 
CK.R3 DEV, -2-2 ; are they blank (0 in RAD50)? 
CMP =(R3) ,- (R3) ; Skip back to device 
Use the new on-line index, INDEX, to find the latest information about topics 


related to .CKXX support. 
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-DREST (Device Handlers Only) - The .DREST macro places device specific 
ion in block 0 of a device handler. The device specific information 


The device classification 


The variants of a device classification and additional information about 
some device classifications 


Whether the device handler contains updatable internal data table(s) 
accessible by SPFUN 372 


The type (device classification) of the updatable internal data table 


Whether the device handler has a table in block 0 that contains 
bad-block replacement information 


ormation is used by RT-11 utilities to determine the characteristics of 


that device handler. 


Macro Ca 


ll: .DREST [class=n] [,mod=n] [,data=dptr] [,type=n] [,replace=rptr] 


mod 
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is the device classification. Specify the device classification 
Symbol (DVC.xx) for nm in the class argument. An octal device 
classification value is stored in byte 20 of block 0 in the device 
handler. Valid device classification symbols and stored values for 
the class argument are: 


Symbol Value Meaning 


DVC.CT 6 Cassette (CT-TA60) tape (CT) 

DVC.DE 10 DECnet executive pseudohandler 

DVC.DK 4 RT-11 file structured disk (DD, DL, DM, ODP, 
Diy DU, DW, Ds, OY, D2, BR) 

DVC.DL sip DECnet port (line) handler 

DVC.DP ii DECnet protocol pseudohandler 

DVC.LP 7 Printer (LP, LS, SP) 

DVC .MT S Magtape (MM, MS, MT, MU) 

DVC.NI LS Ethernet port handler (NC, NQ, NU) 

DVC .NL Hi NULL handler (NL) 

DVC.Fs 14 Pseudohandler (PI, SL) 

DVC TP 3 Reserved 

DVC. TL 2 Terminal class handler (TT) 

DVC .UK 0 Unknown device class 

DVC.Vr 15 Virtual terminal port handler (XL, XC) 


Values in the range of 200 through 377 are reserved for the user. 
indicates a variation or additional information about a device 
classification. Specify the device modification symbol (DVM.xx) 
for nin the mod argument. An octal device modification value is 
stored in byte 21 of block 0 in the device handler. Valid device 
modification symbols and stored values for the mod argument are: 
Symbol Value Meaning 
0 0 No variant or information (default) 


DVM.DM Z With class=DVC.DK, indicates device has an 
extra error word prefixed to SPFUN buffers 


DVM.DX i With class=DVC.DK, indicates device is an 
RX0l-compatible drive 
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DVM.NF 200 With all class devices, indicates handler can 
only be loaded and cannot be fetched. This 
bit is read only and cannot be set using the 
.DREST macro. (This bit is set by the .DRPTR 
macro with the fetch=*NO* argument.) 


DVM.NL 100 With all class devices, indicates handler 
cannot be loaded. 


specifies whether the handler has internal updatable data table(s) 
accessible by SPFUN 372. The data argument information is stored 
in word 72 of block 0 in the handler. You must include the type 
argument if you specify the data argument. For the data argument, 
dptr can be: 


0 The default; specifies that the handler does not have 
an internal data table 


dptrx is the starting address of the internal data table(s) 


specifies whether a device type classification exists for the 
internal data table(s). The device type classification is made up 
of one to three RAD50 characters and is normally the same as _ the 
RT-11 device name. The type argument information is stored in word 
70 of block 0 in the handler. You must include the type argument 
rad if you specify the data argument dptr. For the type argument, 
n can be: 


omitted The default; the handler does not have a device 
type classified internal table 


rad The handler has a device type classified internal 
table, and rad is the RAD50 device type 
classification 


specifies whether the handler has a table in block 0 that contains 
bad-block replacement information. The replace argument 
information is stored in word 32 of block 0 in the handler. For 
the replace argument, rptr can be: 


0 The default; the handler does not contain a bad-block 
replacement information table 


rer is the starting address of a bad-block replacement 
information table 


.DREST arguments are optional, some arguments are paired. FOE 


example, the mod argument has no meaning without the class argument. Also, the 
data argument requires the type argument. 


Errors: 


None 
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SK -- Handler Skeleton 


; .DRPTR/.DREST/.DRSPF - This is an example skeleton handler 
; that illustrates using the .DRPTR, .DREST, and .DRSPF requests. 


f 


.MCALL 
.MCALL 
.MCALL 


. MACRO 


. ENDM 


. DRDEF 


. DRPTR 


.DREST 


. DRSPF 


.DRSET 


. DRDEF :Get handler definitions 
. ASSUME ;Checking macro 
»EALT sTo finish run 


;Define ellipsis (allow 
; ellipsis to assemble) 


;Generate non-executable handler information tables 
containing the following information: 

Handler is SK 

Handler ID is 350 (user written handler) 

Handler accepts neither .READ nor .WRITE 

Handler accepts .SPFUN requests 

Device is 1 block in size 

Device has a CSR at 176543 

Device has a vector at 20 


“Se “Se Neo Se Veo Ne Veo Vo 


SK, 350, RONLYS !WONLYS !SPFUNS,1,176543,20 

;Handler has .Fetch and SLOAD code to be executed: 
FETCH=Fetch, LOAD=Load 

;Handler is for a "Null" class device 

;Handler has a data table called DATABL 

;Data table is of the SKL format 
CLASS=DVC ..NL, DATA=DATABL, TYPE=SKL 


;Handler accepts the following SPFUN codes: 
SS iéy so 165d 


<372,376,377> 


;Handler CSR is not to be checked at install, 
;but is to be displayed: 


-SK 

;Here is any installation check code 
. LE 400,MESSAGE=<; Installation area overflow> 
;Handler accepts SET SK [NO]BONES command: 


BONES, 123456, CORPUS, NO 
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CORPUS: ; SET SK BONES 

COM R3 felipe bats 

NOP ;Pad code 

.ASSUME . EQ CORPUS+4,MESSAGE=<;No option code in wrong place> 
NOCORP : ; SET SK NOBONES 

MOV R3,PICKNT ;Set value in block 1 

RETURN 


.ASSUME . LE 1000,MESSAGE=<;Set area overflow> 


.DRBEG SK ;Handler Queue Manager Entry point 
BR START ;Skip data table 

DATABL: 
~RAD50 "SKL" ;Table ID 

WRIST: .BLKW 1 ;Table contents 

ANKLE: .BLKW 1 ea 


;Set up the Vector table: 


SKSVTB: .DRVTB SK, SKSVEC,SKINT, 0 
.DRVTB ,SKSVEC+4,SKINT, 1 


PICKNT: .BLKW 1 ;Value controlled by Set command 
.ASSUME .-2 LE SKSTRT+1000,MESSAGE=<;Set object 
not 2" block 1> 


START: ;Executable Queue code 
RETURN 
.DRAST SK,4,ABORT ;Interrupt entry point 
BCS INT2 ;Iinterrupt from second vector 
RETURN 

INTZ: ;Second interrupt vector code 
RETURN 

ABORT: ;Abort entry point 
_DRFIN SK ;Completion return 


;End of memory resident part of handler 


.DRBOT SK, ENTRY ;Boot code 
ENTRY: 
ee ;Hard boot code to call read routine 
RETURN 
READ: 
Beat ;Read routine 
RETURN 
.DREND SK ;End of boot code 
.PSECT SETOVR ;Suggested block aligned PSect 
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FETCH: 
oe ;Code executed on FETCH 
RETURN 

LOAD: 
hore ;Code executed on LOAD 
RETURN 

RUN: 
ee ;Code executed on RUN 
~EXLT 
. END RUN 


Use the new on-line index, INDEX, to find the latest information about topics 
related to .DREST support. 


1.5.3.7 .DRINS (Device Handler Only) - The .DRINS macro sets up’ the 
installation code area in block 0 of a device handler. .DRINS defines the 
addresses that contain the CSRs checked by the INSTALL keyboard command code and 
displayed by RESORC and defines the system and data device installation entry 
points. 


See the RT-11 Programmer’s Reference Manual for more information on the .DRINS 


macro. Use the new on-line index, INDEX, to find the latest information about 
topics related to .DRINS support. 


1.5.3.8 .DRPTR (Device Handler Only) - The .DRPTR macro places pointers in 
block 0 of a device handler that refer to handler service routines located in 
that handler. Those handler service routines are used by utilities, monitors, 
and the handler itself. The routines help govern how the handler behaves during 
the following: 

@ Bootstrap (BSTRAP) operations (load argument) 

@® .FETCH and .RELEASE requests 

@ LOAD and UNLOAD commands 

@ Job abort (release argument) 
Macro Call: .DRPTR [fetch=n] [,release=n] [, load=n] [, unload=n] 


where: 


fetch specifies whether a handler service routine is called by the .FETCH 
programmed request. For the fetch argument, n can be: 


0 The default; the handler does not have a_ service 
routine for the .FETCH programmed request. The handler 
can still be fetched 

n is the starting address of the service routine to be 
called by .FETCH 
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*NO* A literal string; the handler cannot be fetched. The 
handler must be loaded 


release specifies whether a handler service routine is called by the 
.RELEASE programmed request. For the release argument, n can be: 


0 The default; the handler does not have a_ service 
routine for the .RELEASE programmed request 


n is the starting address of the service routine to be 
called by .RELEASE 


load specifies whether a handler service routine is called when the 
handler is loaded by bootstrap routine or LOAD command. For the 
load argument, nm can be: 


0 The default; the handler does not have ae service 
routine to be called when it is loaded 


n is the starting address of the service routine to be 
called when the handler is loaded 


unload specifies whether a handler service routine is called when the 
handler is unloaded by the UNLOAD command. For the unload 
argument, nm can be: 


0 The default; the handler does not have a service 
routine to be called when it is unloaded 


n is the starting address of the service routine to be 
called when the handler is unloaded 


.DRPTR arguments are often paired and argument values are often matched because 
routines they point to are used together or rely on each other. The fetch and 
load argument values are often paired. Similarly, the release and unload 
argument values are often the same. 


Handler Service Routine Entry Environment 

The following registers and their contents constitute the handler service 
routine entry environment. These registers (RO through R5) are set up by RT-11. 
All registers are available and none need be preserved. 


RO Contains starting address of the current running handler service 
routine. 


Rl Contains starting address of GETVEC routine if processor is a 


Professional 300 series. If processor is not a Professional 300 
series, Rl contains the address of a routine that always returns carry 
set. 


R2 


R3 


R4 
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Contains the value SSLOT*2. That value is the length of the S$PNAME 
table in bytes. You can use that value to locate information in the 
handler tables concerning this handler. The following table shows the 
order in memory and size in bytes, relative to S$SLOT*2, of the 
pertinent handler tables and the contents of those tables: 


Table Size Contents 


SOWNER: <SSLOT*2>*2 Ownership table; omitted in SJ monitor 

SUNAM1: <SSLOT*2>+4 Physical name of device table 

SUNAM2: <SSLOT*2>+4 Logical name of device table 

SPNAME: SSLOT*2 Installed handlers table 

SENTRY: <SSLOT*2>+2 Handler address table. Last word contains 
value -1 and indicates end of table 


STAT: SSLOT*2 DSTATUS value table 

SDVREC: SSLOT*2 Handler disk block table 

SHSIZE: #§SLOT*2 Handler memory size table 

SDVSIZ: S§$SLOT*2 Device blocks table 

You can use that table in the following manner. R5 contains the 


SENTRY table entry address for this device handler. You could find, 
for example, the name for this handler in the SPNAME table by 
subtracting the value for SSLOT*2 from the value contained in R5. 
Likewise, you could find the DSTATUS value for this handler in the 
SSTAT table by adding the value of <$SLOT*2>+2 to the value contained 
in Ro. 


See Chapter 3 of the RT-11 Software Support Manual for more 
information about the handler tables. 


Indicates the type of entry. The value in R3 indicates the type of 
routine that called the handler service routine: 


Value Meaning 
0 Entered from .FETCH 
Z Entered from .RELEASE 
4 Entered from the LOAD command 
6 Entered from the UNLOAD command 
10 Entered from a job abort 
LZ Entered from a system bootstrap load 


Contains the address of a read routine you can use to perform I/O to 
the system device, which has been opened as nonfile-structured. You 
must load the following registers with the following contents to use 
the read routine: 

Register Contents 


RO Block number to read 
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Rl Number of words to read 

R2 Buffer address 

You can read into only the low 28K words of memory. To read into high 
memory, you must first read into low memory and then move the data. 
The read routine returns with carry clear if no errors; carry bit is 
set if errors. 


Contains a pointer to the SENTRY table entry for this handler. 


Handler Service Routine Error Processing 


The following is the manner in which errors in handler service routines should 
be processed: 


If no errors, exit with carry bit clear. 


If errors, exit with carry bit set. 


The response from RT-11 to handler service routines that exit with the carry bit 
set varies according to the following: 


If the handler service routine was called by the .FETCH request, RTI-11 
refuses to fetch the handler. 


You should not depend on this response with handlers that should never 
be fetched; use the .DRPTR fetch=*NO* parameter instead. 


If the handler service routine was called by the .RELEASE request, RT-11 
releases the handler. 


If the handler service routine was called by the LOAD command, RT-11 
refuses to load the handler. 


If the handler service routine was called by the UNLOAD command, RT-11 
refuses to unload the handler. Further RT-11 response is determined by 
the contents of RO: 


If RO is returned with value zero, RT-11 returns the error message, 
?KMON-F-Unable to unload handler. 


If RO is returned with value other than zero, RT-11 returns the 
error message located at the address contained in RO. 


If the handler service routine was called by a job abort, RT-11 ignores 
the carry bit; the job aborts. 


If the handler service routine was called by a system bootstrap load, 
the handler can clear the carry bit and continue or the handler can send 
an error message to the console terminal, using the following code: 


: <200!DEV.xx> 
6/z 


CODE 
REPORT 
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JSR Rl, @#REPORT 
.WORD MSG 
.BYTE CODE 
MSG: -ASCIZ "message" 
. EVEN 


For processors other than Professional 300 series: 
@® RT-11 ignores the contents of the byte CODE. 
® RT-11 appends the prefix, "?BOOT-U-" to "message". 


For the distributed RT-11, "message" is "Failure to load system 
handler". 


@ The system halts. 

For Professional 300 series processors: 

@® RT-11 ignores the contents of "message". 

@ RT-11 displays the octal value contained in CODE with no prefix. The 
value in CODE should be 200!DEV.XX, where DEV.XX is the device id for 
this handler. You can find DEV.XX for this handler in the SDVREC: 
handler table. 

For the distributed RT-11, CODE is 000013. 

@ The system halts. 

ETrOrs: 
None 
Example: 


See the .DREST example in this manual. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to .DRPTR support. 


1.5.3.9 .DRSPF (Device Handler Only) - The .DRSPF macro defines the special 
function codes supported by a handler. .DRSPF builds a table or tables 
containing the supported special function codes. RT-11 utilities or user 
programs use the table(s) to determine which special function codes are 
Supported by that handler. 


Macro Call: .DRSPF arg[,arg2] 


where: 
arg can be specified in two ways: the list method and the extension 
table method. The list method is the simplest but contains a 
restriction. The extension table method is useful if the 


tig 
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restriction imposed by the list method is a problem. Both ways of 
using arg can be included in the same handler. 


@® List Method - arg can be a list of one or more special function 
codes. That list is located in block 0 of the handler at 
locations 22 through 27. 


You must follow certain rules in specifying the list because of 
the way the special function codes are stored in the handler. 


Special function codes consist of three octal digits. You are 
allowed a total of only three unique ordered combinations of the 
first two digits of a special function code in all lists or 
combination of lists, when arg is used in this manner. You can 
use any octal digit as the third digit of any entry in those 
lists. That restriction is not a problem for most handlers. 
You can define all supported special functions for most handlers 
in one list or series of lists. 


Each list must be enclosed in angle brackets (<>). Special 
function codes are separated by commas (,). The special 
function codes can be specified in any order. 


Do not specify the arg2 argument when using the .DRSPF macro in 
this manner. 


An example list for the MU handler: 
sDRSEF “S005 0; Sil; sa l2palopolapo Opel opal ie 


The same special functions for the MU handler could also be 
included in a series of lists: 


.DRSPF <360> 

«DRBPF <370,371,;3/2> 
«DRSPF <2373;374,3 /5> 
~DREPF <3 /6,3/7> 


In both examples, only two unique ordered combinations of the 
first two digits of the special function codes were used: 36 
and 37. 


Bach of the ordered combinations of the first two digits, 
together with the various third digits supported for that 
combination, are stored in a single word. Bits 8, 9, and 10 of 
that word are reserved for DIGITAL. 


@® Extension Table Method - arg can be a pointer to an extension 
table address. Do not place the extension table in block 0 of 
the handler. 


The pointer to the extension table address must be preceded by a 


plus sign (+). The extension table address must have the high 
bit cleared. 
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arg2 


Errors: 
None 


Example: 


NEW FEATURES 


The extension table contains one or more .DRSPF macros. The arg 
argument for each .DRSPF macro is a minus sign (-), and the argZ 
argument is a list of special function codes. Each of the 
special function codes in arg2 must have the same first two 
octal digits. The list must be enclosed by angle brackets (<>). 
Special function codes are separated by commas (,). The special 
function codes can be specified in any order. The extension 
table is terminated by a word containing zero (0). 


Each of the ordered combinations of the first two digits, 
together with the various third digits supported for that 
combination, are stored in a single word. Bits 8, 9, and 10 of 
that word are reserved for DIGITAL. 


In the following example, the pointer to the extension table is 
the symbol EXTTAB: 


~-DRSPF +EXTTAB 


EXTTAB: 
.DRSPF -,<340,341> 
sDESEE =~<290, 301,305 
.DRSPY =,<200,202,203,204,205> 
sDRSPF =—,<210,212> 
.WORD 0 


is a list of special function codes. Only use the arg2 argument to 
specify special function codes in an extension table, that is, when 
the arg argument is a minus sign (-). See the discussion of the 
arg argument in the extension table method description. 


.MCALL 


. MACRO 
. ENDM 


»~DROPF 
.DRSPF 


. DRSPF 


. DRSPF > Get macro 


Elision macro 

Elision - "act of dropping 
out or suppressing" 

allows ellipsis to assemble 


=e “Se Ne Ve 


* Handler continues... 


<311,3107500,501> ; Standard call 
S30; 04, O06 i ; defining three groups 

, Of code 

; More are supported so 
+XSPTAB ; point to extension table 


L335 
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; Handler continues beyond 


* Dlook 0 
XSPTAB: ; SPFUN extension table 
.DRSPF -,<200,202,207,203> ; 20X group 
.DRSPF =-,<222,224,227,223> ; 22X group 
. WORD 000000 x End of 13st 
. END 


See also the .DREST example in this manual. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to .DRSPF support. 


1.5.3.10 .DRTAB (Device Handlers Only) - The .DRTAB macro sets up a pointer to 
a list of Digital-defined handler data tables that are part of the RT-11 
distributed handlers, and is for DIGITAL use only. A similar macro, .DRUSE, is 
available for user defined handler data tables. 


.DRTAB is included in a distributed handler when that handler contains more than 
one data table. A relationship exists between the .DRTAB macro and the .DREST 
macro and is as follows: 


® When a distributed handler contains only one handler data table, .DREST 
is used to describe that table. 


@ When a distributed handler contains more than one handler data table, 
the .DRTAB macro is used to describe all those tables. The .DREST macro 
can be included in a handler that includes the .DRTAB macro because 
other information can be placed in the handler by .DREST. However, when 
the .DREST macro 1S included in a handler that also includes the .DRTAB 
macro, the .DREST macro does not contain the type and data arguments. 
(The information placed in the handler by those .DREST macro arguments 
would be destroyed [overwritten] by the .DRTAB macro type argument.) 


Macro Call: .DRTAB type,addr,size 


where: 
type is the handler data table format name in one to three RAD50 
characters 
addr is a pointer to the handler data table 
size is the size in bytes of the handler data table 


.DRTAB is invoked once for each handler data table. Each invocation of .DRTAB 
creates a 3-word descriptor containing the values specified for the type, addr, 
and size arguments. A call to .DRTAB with no arguments specifies the end of 
that list of handler data table descriptors. 
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.DRTAB places a pointer to the list of handler data table descriptors in block 0 
of the handler. The list of descriptors and the data tables themselves are not 
located in block 0. When first invoked, .DRTAB sets up locations 70 through 74 
in block 0 with the following contents: 


Location Contents after .DRTAB is invoked 
70 -l1 (indicates use of .DRTAB) 
i2 Pointer to list of handler data table descriptors 
74 Size in bytes of total list of handler data table 
descriptors 


Use the new on-line index, INDEX, to find the latest information about topics 
related to .DRTAB support. 


1.5.3.11 .DRUSE (Device Handlers Only) - The .DRUSE macro sets up a pointer to 
a list of user-defined handler data tables. Use .DRUSE when you want to define 
your own handler data table(s). ; 


Macro Call: .DRUSE type,addr,size 


where: 
type is a handler data table format name in one to three RAD50 
characters 
addr 1S a pointer to the handler data table 
size is the size in bytes of the handler data table 


Invoke .DRUSE once for each user-defined handler data table in your handler. 
Each invocation of .DRUSE creates a 3-word descriptor containing the values you 
specified for the type, addr, and size arguments. Call .DRUSE with no arguments 
to indicate the end of the list of descriptors. 


.DRUSE places a pointer to the list of handler data table descriptors in block 0 
of your handler. Do not place the list of descriptors or the data tables 
themselves in block 0 of your handler. When you first invoke .DRUSE, it sets up 
location 106 in block 0 with the following contents: 
Location Contents after .DRUSE is invoked 
106 Pointer to list of handler data table descriptors 


Example: 


.DRUSE JFW,JIMS,SZJIM 
.DRUSE JBM, JIMS2,SZJIM2 


. DRUSE 
JIMS: . WORD “LIEW Lely Op Spe Or PO 
SZJIM=: ,=71Ms 
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JIMS2: . WORD “rJBM,10,1000,1000000 
SZJIM2=: .-JIMS2 


Use the new on-line index, INDEX, to find the latest information about topics 
related to .DRUSE support. 


1.5.3.12 .FPROT - The .FPROT programmed request sets or resets the protection 
status of files. 


See the RT-11 Programmer’s Reference Manual for details and examples of the 
.FPROT programmed request. Use the new on-line index, INDEX, to find the latest 
information about topics related to .FPROT support. 


1.5.3.13 .PEEK - The .PEEK programmed request returns in register RO the 
contents of the specified low memory location (below 28K words) or the I/0 page 
location you specify. 


See the RI-11 Programmer’s Reference Manual for details and examples of the 
.PEEK programmed request. Use the new on-line index, INDEX, to find the latest 
information about topics related to .PEEK support. 


1.5.3.14 .POKE - The .POKE programmed request deposits the value you _ specify 
into a low memory location (below 28K words) or 1/0 page location. 


See the RT-11 Programmer’s Reference Manual for details and examples of the 
.POKE programmed request. Use the new on-line index, INDEX, to find the latest 
information about topics related to .POKE support. 


1.5.3.15 .PVAL - The .PVAL programmed request modifies or replaces the monitor 
fixed offset location you specify. 


See the RI-11 Programmer’s Reference Manual for details and examples of the 
.PVAL programmed request. Use the new on-line index, INDEX, to find the latest 
information about topics related to .PVAL support. 


1.5.3.16 .SFDAT - The .SFDAT programmed request lets a program set or change 
the creation date in a file’s directory entry. 


See the RT-11 Programmer’s Reference Manual for details and examples of the 


.SFDAT programmed request. Use the new on-line index, INDEX, to find the latest 
information about topics related to .SFDAT support. 
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1.5.3.17 SOB - The SOB macro simulates the instruction "subtract one and branch 
if not equal" (SOB). That macro is useful for writing programs to run on any 
RT-11 supported processor, since the SOB instruction is invalid on _ some 
processors. 


See the RT-11 Programmer’s Reference Manual for more information on the SOB 
macro. Use the new on-line index, INDEX, to find the latest information about 
topics related to SOB support. 


1.5.4 New System Subroutine Library (SYSLIB) Routines 


This section describes the routines that have been added to SYSLIB. 


1.5.4.1 CALLSF - CALLSF can be called only from a MACRO-11 program. 


The CALLSF routine saves the contents of general registers Rl through R4 across 
a call to another routine that might destroy the contents of those registers. 
CALLSF saves the contents of Rl through R4 on the stack, calls the other 
routine, and then restores the saved register contents. 


Form: MOV #rtn, RO 
MOV #arg,R5 
CALL CALLSF 


where: 
ren is the address of the routine you want to call. The current 
contents of registers 1 through 4 are preserved during execution 
of the called routine 
arg is the starting address of the argument list for the routine you 
want to call 
Errors: 


None (any errors are returned by the routine called by CALLSF) 


Example: 
.GLOBAL GTLIN, CALLSF 
; Program code 
MOV #GTLIN, RO ; Routine to call 
MOV #PM,R5 ; Point to parameters 
CALL CALLSF ; Call routine and preserve registers 
; Program code 
PM: .WORD 3 ; Number of arguments in this call 
. WORD BUF 
. WORD PROMe? 
. WORD ee 


ities Ue 
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. BLKB 81. 
PROMPT: .ASCII /Enter username>/<200> 
i aoe -ASCII /P/ 

. EVEN 


Use the new on-line index, INDEX, to find the latest information about topics 
related to CALLSF support. 


1.5.4.2 DATE - RT-11 V5.4B adds the DATE subroutine to SYSLIB. Previously, the 
DATE subroutine was located in the distributed FORTRAN subroutine libraries, 
FORLIB and F7/70OTS. 


The DATE subroutine obtains the current (System) date. The current date is 
stored as a 9-byte string in the form: 


dd-mmm-yy 
where: 
dd is the 2-digit day of the month (with leading zero if necessary) 
mmm. is the 3-digit month (all capital letters) 
VY is the last two digits of the year 


= is the separating character 


Form: CALL DATE (array[(i)]) 


where: 
array is a predefined array that contains at least nine bytes. The 
9-byte string is set to blanks if system date has not been set 
1 specifies which element of that array contains the first element 


of the string 


Use the new on-line index, INDEX, to find the latest information about topics 
related to DATE support. 


1.9.4.3 IDATE - RT-il V5.48 adds the IDATE function to SYSLIB. Previously, the 
IDATE function was located in the distributed FORTRAN subroutine libraries, 
FORLIB and F770OTS. 


IDATE returns three INTEGER*2 values representing the current (system) month, 
day, and year. 


Form: CALL IDATE(i,3j,k) 


1=30 


NEW FEATURES 


where: 

1 1s an INTEGER*2 variable containing an integer representation of 
the month. January is represented as 1. December is represented 
as 12. Returned as zero if the system date has not been set 

is an INTEGER*2 variable containing the integer day of the month 

k is an INTEGER*2 variable containing the positive difference 


between 1900 and the current year 


Use the new on-line index, INDEX, to find the latest information about topics 
related to IDATE support. 


1.5.4.4 IABTIO - The IABTIO routine stops all outstanding I/O operations on a 
specified channel without terminating the job under FB and XM. This routine is 
Simulated under SJ with a .WAIT directive. 


See the RT-1l Programmer’s Reference Manual for details and examples of IABTIO. 
Use the new on-line index, INDEX, to find the latest information about topics 
related to IABTIO support. 


1.5.4.5 IFPROT - The IFPROT routine changes a specified file’s protection 
Status. 


See the RT-11 Programmer’s Reference Manual for details and examples of IFPROT. 
Use the new on-line index, INDEX, to find the latest information about topics 
related to IFPROT support. 


1.5.4.6 IFREER - The IFREER subroutine detaches from a specified global region 
that has been attached to with the IGETR subroutine. IFREER can also eliminate 
that global region when you specify the type argument. IFREER does not 
eliminate a global region that is attached to another job but does detach the 
calling job from that global region. 


see the RT-11 Programmer’s Reference Manual for details on using IFREER. Use 
the new on-line index, INDEX, to find the latest information about topics 
related to IFREER support. 


1.5.4.7 IGETR - The IGETR subroutine attaches to a specified global region. 
IGETR can optionally initialize a global region by reading a portion of a file 
into the global region or by calling a specified subroutine. 


See the RT-11 Programmer’s Reference Manual for details on using IGETR. Use the 
new on-line index, INDEX, to find the latest information about topics related to 
IGETR support. 
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1.5.4.8 IGIDUS - The IGTDUS subroutine provides information about a specified 
MSCP (DU) or TMSCP (MU) class device unit. Issue the IGTDUS subroutine only to | | 
MSCP or TMSCP class devices. Information returned by IGTDUS includes: Raa 
@ Whether the device unit is off line, available, or on line. 
@ Whether the device media is removable (for example, the RC25). 
@ Whether the device unit 18 write protected. 
@ Whether the device controller supports bad block replacement. (MSCP 
only) 
@ The octal number of physical addressable blocks in the device unit. 
(MSCP only) 
® The media name, such as RC25, RA80, RA81, RD31, RD32, RD51, RD52, RD53, 
ROS4, BXSS, RXOU, TKSC, or TuUel, 
Form: i1=IGTDUS (devnam, chan, buf[,unit][,type] [,work]) Wow 
where: 
devnam is the Radix-50 device name (MSCP or TMSCP class devices only) 
chan is the integer specification for an RT-11 channel to be opened by 
IGTDUS 
buf is the address of a 7-word buffer containing status information 


returned by IGTDUS. The information returned by IGTDUS in the WS 
status buffer includes: 


buf+0 is the status information word. The following 
values can be returned in the status information 
word: 
0 = The device unit is on line 
1 = The device unit is available | | 
wy 
2 = The device unit is off line 
buf+2 is the unit flag word. One or more of the 
following values can be returned in the unit flag 
word: 
200 = The media is removable 
20000 = The media is write protected 
100000 = The MSCP device controller supports 
bad-block replacement, or the TMSCP 
controller supports tape write-back 
caching 
| 


| ie 
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buf+4 For MSCP, are the unit size words. The 
buf+6 unit size 1s returned as a 28-bit octal 
value (16 bits in buft+t4 and 12 bits in buf+6). 
For TMSCP, are the recommended maximum record size 


in bytes 
buf+10 Is the media device name in 5 bytes of 
buf+12 alphanumeric ASCII characters followed 


buf+14 by a null byte 


unit is the unit number requested. The meaning of unit is determined 
by the type parameter: 


If the type parameter is ’RT11’, the unit parameter is 
optional and is the RT-11 unit number. The valid range is 0 
through 7. If unit is not specified, the default unit is 
that specified in the devnam parameter. 


If the type parameter is /’MSCP’, the unit parameter is 
required and is the MSCP physical unit number. The valid 
range is 0 through 255. 


type is the type of unit number requested. Type is a character 
constant, specified as ’RT11’ (the default) or ’MSCP’: 


Type parameter ’RT11’ supports TMSCP and MSCP devices. 


Type parameter ’MSCP’ supports TMSCP and MSCP devices and 
requires the unit parameter. 


work is a recommended 80-word work area used internally by IGTDUS. If 
you do not define a work area, IGTDUS takes 80 words from the 
processor stack area. Allow for that when planning stack 


allocation to avoid stack overflow 
Use the IGTDUS subroutine to determine the unit size before issuing the JREAD 
and JWRITE subroutines to MSCP devices or anytime you need status information 
concerning an MSCP or TMSCP device. 
Errors: 


i= QO Normal return. 


-1. Logic error. Retry the operation. If the error persists, submit 
an SPR to DIGITAL; see Appendix B. 


-2. Logic error. Retry the operation. If the error persists, submit 
an SPR to DIGITAL; see Appendix B. 


-3. Logic error. Retry the operation. If the error persists, submit 
an SPR to DIGITAL; see Appendix B. 


-4, Attempt to read or write past end-of-file or invalid function 
value. 
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-5. Hard error occurred on channel. 

-6. Channel is not open. 

-7, Reserved. 

-8. Reserved. 

-9,. Reserved. 
-~10. Reserved. 
-ll. Reserved. 
-12. Reserved. 
-13. Handler is not loaded. 
-14, Handler is not installed. 
-15. Channel is already in use. 
-16. File indicated was not found on the device. 
-17. File already open on a nonshareable device. 


-18. Device does not support MSCP or TMSCP. Inappropriate device for 
IGTDUS subroutine. 


-19. First character of type argument is not an ’m’ or ‘r’. 
-20. Required argument is missing (devnam, chan, or buf arguments). 
-21. Magtape file sequence number is invalid. 


The following errors can be returned by IGTDUS if the .SERR programmed request 
2S) a SO ece. 


i = -129. Called USR from completion routine. 
«1 30. No device handler; this operation needs one. 


“131, .Exror doing directory 1/0, 


=i 22. .FETCH error. An I/O error occurred while the handler was 
being used, or an attempt was made to load the handler over USR 
or KMON. 

a Error reading an overlay. 

-134. No more room for files in the directory. 


eee Reserved. 


“136. 


ag Af a 


=—L3c. 


=i: 


-140. 


Lal, 


mlaZ. 


—l43., 


-144, 


=Le0 


-146. 


Example: 


QAaadqaaqa 


100 


Use the new on-line index, INDEX, to find the latest 
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Invalid channel number; number is greater than actual number of 


Channels that exist 


Invalid EMT, and invalid function code has been decoded. 


Reserved. 
Reserved. 


Invalid directory. 


Unloaded XM handler. 


Reserved. 
Reserved. 
Reserved. 
Reserved. 


Reserved. 


INTEGER*2 DEVNAM, ISTAT (7) , IWORK (80) 
DATA DEVNAM/3RDU0/ 
ICHAN = IGETC() 

IF (ICHAN.LT.Q) STOP ’NO CHANNEL’ 
ICODE = IGTDUS (DEVNAM, ICHAN, ISTAT, , , IWORK) 


LE 4 
IF { 


TCODE. dal. U) “SIOP 


ISTAT(1) .NE. 0 ) STOP ’DRIVE ERROR’ 


"BAD IGTDUS’ 


The following program uses IGTDUS to get and print 
the media type 


TYPE *,’THE MEDIA TYPE FOR THIS DRIVE IS ’ 
TYPE 100, (ISTAT(J) ,d= 5,7) 
FORMAT (’ ',3A2) 
CALL EXIT 


STOP 
END 


related to IGTDUS support. 


1.5.4.9 IPUT - The IPUT routine modifies or replaces the value of a monitor 


fixed offset location. 


information about topics i 


See the RT-11 Programmer’s Reference Manual for details and examples of MIPUT. 


Use the new on-line index, INDEX, to find the latest information about topics 


related to IPUT support. 
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1.5.4.10 ISDTTM - The ISDTTM routine modifies the current date and time values 
stored in the monitor. 


See the RT-11 Programmer’s Reference Manual for details and examples of ISDTIM. 
Use the new on-line index, INDEX, to find the latest information about topics 
related to ISDTIM support. 


1.5.4.11 ISFDAT - The ISFDAT routine sets or changes the creation date in a 
file’s directory entry. 


See the RT-11 Programmer’s Reference Manual for details and examples of ISFDAT. 
Use the new on-line index, INDEX, to find the latest information about topics 
related to ISFDAT support. 


1.5.4.12 JREAD/JREADC/JREADF/JREADW - The functions JREAD, JREADC, JREADF, and 
JREADW use non-file-structured access to transfer into memory a specified number 
of words from an MSCP device. JREAD, JREADC, JREADF, and JREADW are especially 
useful because they use a 28-bit starting block number and can therefore read 
from any block on any DU device. 


Those functions require a queue element. Allow for that queue element when the 
IQSET function is executed. 


JREAD 

The JREAD function transfers into memory a specified number of words from an 
MSCP device associated with the indicated channel. The monitor returns control 
to the user program immediately after the JREAD function is initiated. No 
special action is taken when the transfer is completed. 

Form: 1 = JREAD (wcnt,buff, jblock, chan[,area]) 

where: 


went is the integer number of words to be transferred 


burt 1s an array to be used as the buffer; that array must contain at 
least went words 


iDLock is the 2-word (32-bit) starting block number of the MSCP device 


to be read. The first word contains the low order bits. The 
second word contains the high order bits. For all 
currently-supported Digital MSCP devices, the high 4 bits of the 
second word must be zero. (In FORTRAN-77, jblock can be 
expressed aS an INTEGER*4 variable, and can be manipulated as 
such. ) 


The first block of the MSCP device is physical block 0. The 
first block of each MSCP device partition is logical block 0. 
The jblock argument is offset from physical or logical block 
number 0. The jblock argument refers to a physical block when 
the MSCP disk has not been partitioned, or to a logical block 
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when the MSCP disk has been partitioned. When an MSCP disk has 
been partitioned, the block you address with the jblock argument 
depends on which partition is assigned to the RT-11 unit (DUO: 
through DU7:) 


The jblock argument must be updated (incremented) when necessary. 
For example, if the program is reading two blocks at a time, 
jblock should be incremented by 2 for each read 


chan is the integer specification for the RT-11 channel to be used 

area is a recommended 80-word work area that is used internally by 
JREAD . If you do not define a work area, JREAD takes 80 words 
from the processor stack area. Allow for that when planning 


stack allocation to avoid stack overflow 


Issue an IWAIT function when the user program needs to access the data read on 
the specified channel. IWAIT makes sure that the JREAD operation has been 
completed. IWAIT indicates if a hard error occurs during the transfer. 


Errors: 
1 = 0 Normal return. 
= -2 Hardware error occurred on channel on last completed operation. 
= og Specified channel is not open. 
= -4 Invalid device (not DU). 
Example: 


See the JREADW example in this manual. 
JREADC 
The JREADC function transfers into memory a specified number of words from the 
indicated channel. The monitor returns control to the user program immediately 
after the JREADC function is initiated. When the operation is complete, the 
monitor enters the specified assembly language routine (crtn) as an asynchronous 
completion routine. 
Form: 1 = JREADC (went,buff, jblock,chan[,area],crtn) 


where: 


went, buff, jblock, chan, and area are the same as the JREAD function 


Crin is the assembly language routine to be activated when the 
transfer is complete. That routine must be specified in the 
EXTERNAL statement in the FORTRAN routine that issues the JREADC 
FUNCT Lon 
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Errors: 
= v Normal return. 
= -2 Hardware error occurred on channel on last completed operation. 
= -3 Specified channel is not open. 
= -4 Invalid device (not DU). 
Example: 


See the JREADW example in this manual. 
JREADF 


The JREADF function transfers into memory a specified number of words from the 
indicated channel. The monitor returns control to the user program immediately 
after the JREADF function is initiated. When the operation is complete, the 
monitor enters the specified FORTRAN subprogram (crtn) as an asynchronous 
completion routine. (See Section 1.2.1.2 of the RT-1l Programmer’s Reference 
Manual for information on completion routines.) 


Form: i = JREADF (wcent,buff, jblock, chan[,area],lblk,crtn) 
where: 
went, buff, jblock, chan, and area are the same as the JREAD function 
ible is a 4-word area to be set aside for link information; this area 
must not be modified by the FORTRAN program or swapped over by 
the USR. This area can be reclaimed by other FORTRAN completion 
functions when crtn has been activated 
Srin is the FORTRAN routine to be activated on completion of the 


transfer. This name must be specified in an EXTERNAL statement 
in the routine that issues the JREADF call 


Errors: 
1 = 0 Normal return. 
= -2 Hardware error occurred on channel on last completed operation. 
=a Specified channel is not open. 
= -4 Invalid device (not DU). 
Example: 


See the JREADW example in this manual. 
JREADW 
The JREADW function transfers into memory a specified number of words from the 
indicated channel. The monitor returns control to the user program when the 


transfer is complete or when an error is detected. 


Form: i = JREADW (wcent,buff, jblock, chan[,area]) 


ww 
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where: 


went, buff, jblock, chan, and area are the same as the JREAD function 


Errors: 
i1=n Normal return; n equals the number of words requested. If went 
1s greater than the number of words remaining in the MSCP device, 
n is the number of words transferred. 
= az Hardware error occurred on channel. 
= -3 Specified channel is not open. 
= -4 Invalid device (not DU). 
Example: 
& 


C The following example reads block number 65,540 and writes 
C it to block number 65,685. 


C 

C JREADW/ JWRITW 

C 
INTEGER*2 DBLK(4) , BUFFER (256) , BLKNO (2) , BLKNO2 (2) 
INTEGER*2 WORKA (80) ! WORK AREA 
DATA DBLK/3RDU0,0,0,0/ 
DATA BLKNO/5,1/ ! INPUT 28-BIT BLOCK 
DATA BLKNO2/150,1/ ! OUTPUT 28-BIT BLOCK 
ICHAN= IGETC() 
IF (ICHAN.LT.0) STOP ’NO CHANNEL AVAILABLE’ 
IF (IFETCH(DBLK) .NE.0) STOP ’BAD FETCH’ 
IF (LOOKUP (ICHAN,DBLK) .LT.0) STOP ’BAD LOOKUP’ 
ICODE = JREADW (256, BUFFER, BLKNO, ICHAN, WORKA) 
IF {ITCODE+1) 300,200, 10 

10 ICODE = JWRITW (256, BUFFER, BLKNO2, ICHAN, WORKA) 
IF (ICODE+1) 300,200,100 

100 CALL PRINT (7 SUCCESSFUL OPERATION’ ) 
CALL EXIT 
STOP 

200 STOP ‘END OF DEVICE’ 

300 STOP "HARDWARE ERROR’ 
END 


Use the new on-line index, INDEX, to find the latest information about topics 
related to JREAD/JREADC/JREADF/JREADW support. 


1.5.4.13 JWRITE/JWRITC/JWRITF/JWRITW - The functions JWRITE, UJWRITC, OJWRITF, 
and JWRITW use non-file-structured access to transfer a specified number of 
words from memory to an MSCP (DU) device. JWRITE, JWRITC, JUWRITF, and JWRITW 
are especially useful because they use a 28-bit starting block number and can 
therefore write to any block on any DU device. 
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CAUTION 


If you are unsure about the physical size of an MSCP device, use 
the IGTDUS subroutine to determine the size of that device. If 
you specify a block number higher than the device size returned 
by IGIDUS, you can corrupt formatting and bad-block replacement 
information contained on the device. That makes the device 
unusable, and you must reformat it. Formatting a device removes 
all information contained on that device. Be very careful to 
specify a starting block that is lower than the device size 
returned by IGTDUS. 


@ The JWRITE, JWRITC, JWRITF, and JWRITW functions require a queue element. Allow 


for that queue element when the IQSET function is executed. 
JWRITE 
The JWRITE function transfers a specified number of words from memory to the 
specified channel. The monitor returns control to the user program immediately 
after queuing the request. No special action 1s taken upon completion of the 
operation. 
Form: i = JWRITE (wcent,buff, jblock, chan[,area] ) 
where: 

went is the integer number of words to be transferred 


buff 1S an array to be used as the output buffer 


jblock is the 2-word (32-bit) starting block number of the MSCP device 


to be read. The first word contains the low order bits. The 
second word contains the high order _ Obits. For all 
currently-supported Digital MSCP devices, the high 4 bits of the 
second word must be zero. (In FORTRAN-77, jblock can be 
expressed as an INTEGER*4 variable, and can be manipulated as 
such. } 


The first block of the MSCP device is physical block 0. The 
first block of each MSCP device partition is logical block 0. 
The jblock argument is offset from physical or logical block 
number 0. The jblock argument refers to a physical block when 
the MSCP disk has not been partitioned, or to a logical block 
when the MSCP disk has been partitioned. When an MSCP disk has 
been partitioned, the block you address with the jblock argument 
depends on’ which partition is assigned to the RT-11 unit (DUO: 
through DU7:). Do not specify a block number higher than the 
physical size of the device (the physical size of an MSCP device 
is returned by the IGTDUS function) 


The jblock argument must be updated (incremented) when necessary. 


NEW FEATURES 


For example, if the program is reading two blocks at a time, 
jblock should be incremented by 2 for each write 


chan is the integer specification for the RT-11 channel to be used. 
You must obtain this channel through an IGETC call, or you can 
use Channel 16(decimal) or higher if you have done an ICDFN call 


area is a recommended 80-word work area that is used internally by 
JWRITE. If you do not define a work area, JWRITE takes 80 words 
from the processor stack area. Allow for that when planning 


Stack allocation to avoid stack overflow 


Errors: 
1=0 Normal return. 
= =z Hardware error occurred on channel on last completed operation. 
= -3 Channel is not open. 
= -4 Invalid device. 
Example: 


See the JREADW/JWRITW example in this manual. 
JWRITC 
The JWRITC function transfers a specified number of words from memory to the 
specified channel. The monitor queues the request and returns control to the 
user program. When the transfer is complete, the monitor enters the specified 
assembly language routine (crtn) as an asynchronous completion routine. 
Form: i = JWRITC (went,buff, jblock, chan[,area],crtn) 


where: 


went, buff, jblock, chan, and area are the same as the JWRITE function. 


ertn is the assembly language routine to be activated when the 
transfer is complete. That routine must be specified in the 
EXTERNAL statement in the FORTRAN routine that issues the JWRITC 
function 
Errors: 
i= 0 Normal return. 
= 2 Hardware error occurred on channel on last completed operation. 
= =3 Channel is not open. 
= -4 Invalid device. 
Example: 


See the JREADW/JWRITW example in this manual. 
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JWRITF 


The JWRITF function transfers a specified number of words from memory to the 
specified channel. The monitor returns control to the user program immediately 
after queuing the request. When the transfer is complete, the monitor enters 
the specified FORTRAN subprogram (crtn) as an asynchronous completion routine. 
(See Section 1.2.1.2 of the RT-11 Programmer’s Reference Manual for information 
on completion routines.) 


Form: i = JWRITF (wcent,buff, jblock,chan[,area],1lb1lk,crtn) 
where: 
went, buff, jblock, chan, and area are the same as the JWRITE function 
lblk is a 4-word area to be set aside for link information; this area 
must not be modified by the FORTRAN program or swapped over by 
the USR. This area can be reclaimed by other FORTRAN completion 
functions when crtn has been activated 
ertn is the FORTRAN routine to be activated on completion of the 


transfer. This name must be specified in an EXTERNAL statement 
in the routine that issues the JWRITF call 


Errors: 
1 = 0 Normal return. 
= <2 Hardware error occurred on channel on last completed operation. 
= «3 Channel is not open. 
= -4 Invalid device. 
Example: 


See the JREADW/JWRITW example in this manual. 
JWRITW 
The JWRITW function transfers a specified number of words from memory to the 
specified channel. The monitor returns control to the user program when the 
transfer is complete. 
Form: i = JWRITW (wcent,buff, jblock,chan[,area]) 
where: 

went, buff, jblock, chan, and area are the same as the JWRITE function 


Brrors: 


Z 


ll 
0 


Normal return; n equals the number of words written. 
2 Hard error occurred on the channel. 

Channel is not open. 

Invalid device. 


now lt 
i f 
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Example: 
See the JREADW/JWRITW example in this manual. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to JWRITE/JWRITC/JWRITF/JWRITW support. 


1.5.4.14 RAN/RANDU - RT-11 V5.4B adds the RAN function and RANDU subroutine 
uniform pseudorandom number generators to SYSLIB. Previously, RAN and RANDU 
were located in the FORTRAN IV and FORTRAN-77 object time system libraries. RAN 
and RANDU are different from the routines previously supplied with FORTRAN IV. 
They are the same as the default routines previously supplied with FORTRAN-77. 


RAN and RANDU generate a floating-point number that is evenly distributed in the 
range between 0.0 inclusive and 1.0 exclusive (1.0 is never generated). 


You supply a 32-bit seed number, and that seed number is automatically updated 
according to the following: 


SEED = 69069 * SEED +1 (MOD 2**32) 


The value of SEED is a 32-bit number. The high-order 24 bits of SEED are 
converted to floating point and returned as the result (f). 


Form: f£ = RAN (jseed) 


io f = RAN (iseedl1,iseedZ2) 
Ors 
CALL RANDU (iseedl1,iseedZ2, f) 
where: 
id is a 32-bit floating-point variable 
jseed is an INTEGER*4 seed number 


iseedl is the low-order INTEGER*2 seed variable 

iseed2 1s the high-order INTEGER*2 seed variable 
RAN and RANDU are multiplicative congruential general random number generators. 
They are fast, but prone to nonrandom sequences if you construct and analyze 
triples of generated numbers. 


There are no restrictions on the seed. The seed should be initialized to 
different values on separate runs to obtain different random sequences. 


Example: 


This example illustrates a simple way to get a uniform random integer 
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selector. Multiply the value returned by the RAN function by the number of 
cases - in this example five. 


VAS 


GO TO (1,2,3,4,5), (1 + IFIX(5.*RAN (JSEED) ) ) 


The explicit IFIX is necessary before adding 1 to avoid possible rounding 
during the normalization after the addition of floating-point numbers. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to RAN/RANDU support. 


1.5.5 New Handlers 


RT-11 V5 includes the following handlers. 


1.5.5.1 DU (MSCP Handler) - The DU handler supports disk systems that implement og 
the mass storage communication protocol (MSCP). Presently, RT-11 supports the 
following MSCP storage systems: RX33 and RX50 diskettes, RC25 disk, RA80 and 

RA81 disks, RD31, RD32, RD51, RD52, RD53, and RD54 disks. 


Changes have been made to the DU handler. See Chapter 2 for details. 
See Section 10.11 of the RY-11 Software Support Manual for more information on 


the DU handler. Use the new on-line index, INDEX, to find the latest 
information about topics related to DU support. 


a 
1.5.5.2 DW (Professional 350 and 380 Hard Disk Handler) - The DW handler 
supports the 5M-byte RD50, the 20M-byte RD31, the 10M-byte RD51, approximately 
32.5M-bytes of the RD32, and the 33M-byte RD52 fixed hard disks. RT-11 supports 
only drive unit DWO. 

Use the new on-line index, INDEX, to find the latest information about topics 
related to DW support. 


1.5.5.3 DZ (Professional 300 Series Diskette Handler) - The DZ handler supports 
RX50 diskette drives for the Professional 300 series computers. RT-11 supports 
drive units DZO and DZ1. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to DZ support. 


1.5.5.4 MU (TMSCP handler) - The MU handler supports magtape systems that use 
the tape mass storage communication protocol (TMSCP). The MU handler supports 
up to four units. Each unit requires a separate controller. 
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You should LOAD the MU handler before you use a TMSCP magtape device. A TMSCP 
device operates much faster when you LOAD the MU handler. Because of the size 
of the MU handler, you should UNLOAD the MU handler when you are not using the 
TMSCP device; for example, after using the TMSCP device for backup operations. 


See the RT-11 Software Support Manual for information about MU. Use the new 
on-line index, INDEX, to find the latest information about topics related to MU 
SUPPOrL. 


1.5.5.5 NC, NQ, and NU (Ethernet Handlers) - The NC, NQ, and NU _ handlers 
support Ethernet-class devices. NC supports the DECNA Ethernet controller for 
Professional 300 series processors. NQ supports the DEQNA Ethernet controller 
for Q-bus PDP-11 processors. NU supports the DEUNA Ethernet controller for 
UNIBUS processors. Each Ethernet handler supports one Ethernet controller. The 
NC, NQ, and NU handlers run only under the XM monitor. The NU handler uses the 


same .SPFUN function codes and has the same restrictions as the NC and NQ 


handlers. 


See the RT-11 Software Support Manual for information on using the NC and NQ 
Ethernet handlers. Information in that manual for the NC and NQ handlers also 
applies to the NU handler. Section 3.4.4 of this manual contains an example 
program that illustrates Ethernet unit allocation for the NC, NQ, and NU 
Ethernet handlers. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to NC/NQ/NU support. 


1.5.5.6 PI (Professional Interface Handler) - The Professional interface (PI) 
handler supports the keyboard, video display, and system clock for Professional 
300 series computers. Although you cannot alter PI handler characteristics or 
direct I/0 operations to PI, PI.SYS (or PIX.SYS under the XM monitor) must 
reside on your system volume if you are running on a Professional 300 series 
computer. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to PI support. 


1.5.5.7 SD (DBG-11 Debugger Pseudohandler) - Four variants of the SD handler 
(SDH, SDHX, SDS, and SDSX) support the DBG-11 symbolic debugging package: 


SDH.SYS Hardware I/O version of DBG-11 for use with the SJ and FB 
monitors 


SDHX.SYS Hardware I/O version of DBG-11 for use with the XM monitor 


SDS.SYS Software I/O version of DBG-11 for use with the SJ and FB 
monitors 
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SDSX.SYS Software I/O version of DBG-11 for use with the XM monitor 


See the DBG-11 Symbolic Debugger User’s Guide for information. 


1.5.5.8 SP (Transparent Spooler Handler) - The SP pseudohandler supports the 
transparent spooler (SPOOL). The SP handler intercepts output directed to the 
line printer and sends it to SPOOL for temporary storage and printing. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to SP support. 


1.5.5.9 XC and XL (Communication Port Handler) - XC and XL are 
non-file-structured communications handlers. They support the virtual terminal 
communication package, VTCOM. However, their design does not preclude their use 
in other communication programs. The XC handler supports the Professional 300 


series computer communication port. The XL handler supports DL(V)-11 
communication ports. XC or XL (depending on your system) is required when you 
use VTCOM. 


XC and XL support the VICOM utility, using .READx, .WRITx, and .SPFUN programmed 
requests. The following describes information specific to the XC and XL 
handlers for those requests. 


~-READx and .WRITx Support 


The XC and XL handlers support the .READ, .READC, .READW, .WRITE, .WRITC, and 
.WRITW requests. You use the .READx and .WRITx requests with XC and XL handlers 
as described in the R7J-11 Programmer’s Reference Manual. Note, however, the 
following additional information: 


@ You should specify the value 0 in the blk argument for the first request 
to XC or XL. All subsequent calls should specify a nonzero value for 
the blk argument. 


@e NULL characters are ignored by XC and XL during both .READS from and 
.WRITES to the handlers. 


@e XC and XL pass only 7-bit data. The eighth (high-order) bit is stripped 
from each byte. 


-SPFUN Support 
In general, the XC and XL handlers support the .SPFUN request as described in 
the RT-11 Programmer’s Reference Manual. Note, however, the following general 
information: 

@ You should specify the value 0 in the blk argument for the first request 


to XC or XL. All subsequent calls should specify a nonzero value for 
the blk argument. 
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@ NULL characters are ignored by the XC and XL handlers; NULL characters 


f~ are not stored or sent. However, .SPFUN 203 uses a NULL character to 
| Signal the end of available data (see .SPFUN 203 below). 
® XC and XL pass only 7-bit data. The eighth (high-order) bit is stripped 
from each byte. 

The XC and XL handlers support the following special function codes. Specific 

information about using an .SPFUN request with XC or XL is included in the 

description for that request. 

Code Label Description 

201 SP, CLR Resets the internal flag, indicating a received XOFF. Then 
sends an XON to the host. 

Example: 
ro, .SPFUN #area,#chan, #201, #buf, #went, #b1k[, #crtn] 

202 SP .BRK Sets or resets the state of the BREAK bit in the serial 
interface. Transition of the BREAK bit from 0 to 1 to 0 can 
get the attention of certain communications devices, such as 
terminal concentrators. 

The went argument is a flag that indicates whether the BREAK 
bit should be set or reset. Specify a value of 1 for the 
wont argument to set the BREAK bit; specify 0 to reset it. 
rrr DIGITAL recommends you use some time delay between turning 
the bit on and turning it off; do that by sending one or two 
characters. 
Examples: 
To turn on (set) the BREAK bit: 
.SPFUN #area,#chan, #202, #buf, #1, #b1k[, #crtn] 
f \ To turn off (reset) the BREAK bit: 
.SPFUN #area,#chan, #202, #buf, #0,#b1k[,#crtn] 

203 SP .SRD Performs a special read from the handler. The went argument 
specifies the number of bytes to be read. The read is 
completed when one of the following conditions is met: 

e The number of bytes specified in the went argument 
have been transferred. 

e The available characters have been transferred, when 
the number of available characters was less than the 
value specified in the went argument. 

f ; 


L322 


204 


Sr sole 


NEW FEATURES 


@e One character has been transferred, when no 
characters were available when the request was 
issued. 


The byte following the last transferred character contains a 
NULL. You must allow for that NULL byte in your buffer. 


Example: 


The following example reads no more than six (but at least 
one) characters from XC or XL and places them in the buffer 
RCVBUF. RCVBUF must be at least seven bytes in length to 
receive the six characters and the NULL byte. 


.SPFUN #area,#chan, #203, #RCVBUF, #6,#b1k[,#crtn] 


Returns the driver status in the first word of the specified 
buffer. .SPFUN 204 always returns one word. 


The high byte of the returned word contains the driver 
support level. The driver support level number will be 
updated as support is changed in the XC and XL handlers. 
Programs should verify operation with an established driver 
support level. The driver support level for RT-11 V5.4D is 
18 (decimal). 


The low byte contains the status of two internal flags and a 
modem control signal. The significant bits of the low byte 
are: 


Bit Meaning 


0 Set if an XOF has been sent to the host. 

cl Set if an XOFF has been received from the host. 

Z Set if the CLEAR TO SEND line is set. 

3 Set if Carrier Detect is high (on); clear if 


Carrier Detect is low (off). 


£ Set if Ring Indicator is high (on); clear if Ring 
indicator is low (orf). 


5-7 Reserved 
Example: 
The following example returns the driver support level in 
the high byte, and the status of internal flags in the low 
byte of the l-word buffer STATUS. 


.SPFUN #area,#chan, #204, #STATUS, ¢went, #b1k[,#crtn] 


I-36 


NEW FEATURES 


205 SP .OFF Sets a flag that disables interrupts when the program exits. 
DIGITAL recommends you issue .SPFUN 205 before your program 
exits. 

Example: 


.SPFUN #area, #chan, #205, #buf, #wcnt, #b1k[,#crtn] 


206 SP ,DTR Sets or resets the state of the DTR modem control _ signal. 
Setting (asserting) DTR can cause modems to answer an 
incoming call. Resetting (deasserting) DTR can cause modems 
to terminate a current call. DTR can also get the attention 
of certain communications devices such as the Mini-Exchange. 
Specify a value of 1 for the went argument to set the DTR 
control signal; specify 0 to reset the DTR control signal. 


Not all interfaces support the DTR control signal. On 
interfaces that do not support DTR, the setting or resetting 
of DTR has no effect. 

Example: 

The following example sets the DTR control signal: 

.SPFUN #area,#chan, #206, #buf, #1, #b1lk[,#crtn] 

The following example resets the DTR control signal: 


.SPFUN #area,#chan, #206, #buf, #0, #b1k[,#crtn] 


Use the new on-line index, INDEX, to find the latest information about topics 
related to XC and XL support. 


1.5.5.10 VM (Memory Disk Handler) - The VM handler allows memory above 28K 
words to be used as though it were a disk device. That virtual device can be 
used as the system volume or as a data volume. 


See Appendix C for information on using VM as your system volume. 

RT-11 requires using VM to support the use of memory above 256K bytes on UNIBUS 
machines. Therefore, DIGITAL does not recommend the removal of the VM handler 
or changing the base on 22-bit UNIBUS systems (11/24, 11/44, 11/70, and 11/84). 
See Section 10.12 of the RT-11 Software Support Manual for more information on 


the VM handler. Use the new on-line index, INDEX, to find the latest 
information about topics related to VM support. 
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1.5.6 New Extended Memory Subroutine 
A new extended memory subroutine, XDEALC, has been added to the file XMSUBS.MAC. 


XDEALC returns a specified section of extended memory to the free memory list 
maintained by RT-11. The entry point for XDEALC is $P1EXT-18 (decimal) . 


The address and size of the section of extended memory to be returned are 
specified in units of 32(decimal) words. Load Rl with the starting address 
divided by 32(decimal) and R2 with the size of the region in units of 
32 (decimal) words. 


In the following example, RO contains the address of SP1EXT and XDEALC is 
-18 (decimal). 


mov #region address,Rl ; Address in units of 32. words 
MOV #region size,R2 ; Size in units of 32. words 
CALL XDEALC (RO) 


On return from XDEALC, the carry bit is clear if the memory was returned. ifs 
the carry bit is set, the memory was not returned because the free memory has 
become too fragmented. 


XDEALC destroys the contents of Rl and R2. If you want to preserve the contents 
of those registers across the call, you must save them. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to XDEALC support. 


1.5.7 New System Generation Procedures and Options 


The system generation process is controlled by the indirect control file 
processor, IND, and includes support for additional options. See the R7-11 
System Generation Guide for a complete description of system generation. Use 
the new on-line index, INDEX, to find the latest information about topics 
related to the system generation (SYSGEN) procedure. 


1.5.7.1 New System Generation Procedures - The RT-11 V5 system generation 
procedures are no longer controlled by a FORTRAN IV program (SYSGEN.SAV). 
Instead, system generation is run using the IND control file processor. The 
system generation procedures, however, remain basically the same: system 
generation produces new monitors and handlers depending on your answers to 
SYSGEN.COM dialog questions. (SYSGEN.COM is an IND control file that replaces 
SYSGEN.CND and the device section of SYSTBL.CND.) 


The major changes to the system generation procedures are: 


@® You can create an answer file to preserve your responses during a system 
generation session. You can use this answer file during later system 
generation sessions to recreate the same system without answering the 
dialog questions again. 
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After answering the system generation dialog questions, you have the 
Opportunity to change some of your answers. If you are using an answer 
file, you can also change some responses. The new responses are 
recorded in the output answer file, if you request one. 


All work files associated with a system generation session use the same 
name as the answer file but have a different file type. For example, if 
the answer file is NEWSYS.ANS, the work files are named NEWSYS.BLD, 
NEWSYS.MON, NEWSYS.DEV, NEWSYS.CND, and so on. The default answer file 
is SYSGEN.ANS. 


The system generation dialog lets you define system conditionals for 
which there are no system generation questions. For example, you must 
define the conditional LIGH$T = 1 to enable support for the idle-loop 
light pattern. Conditional definitions are then included in the answer 
file and the .CND (conditional) file created during system generation. 
That feature lets you define system conditionals without having to edit 
the .CND file. The .ANS file will contain all system generation 
information. 


see the RT-1l1 System Generation Guide for more information on defining 
system conditionals during system generation. 


You can create the .CND conditional files for the distributed monitors 
by performing a system generation and using the appropriate monitor 
answer file (BL.ANS, SJFB.ANS, or XM.ANS) as input. 


Instead of choosing the long or short form of the dialog, you can 
request explanatory text for individual questions by typing <ESC><RET> 
(on VT100 or VT100-compatible terminals only). 


SYSGEN.TBL, a new file produced during the system generation session, 
contains the device tables that were included in the file SYSTBL.MAC. 
SYSGEN.TBL is included during the assembly and link procedure for all 
monitors you generate. If you use an answer file during the system 
generation session, the resulting device tables file will have the same 
name as the answer file but with the file type .TBL. The new file 
TRMTBL.MAC, which contains the multiterminal tables, is distributed on 
the RT-11 V5 distribution kit and is included in the assembly and link 
procedure only if you request multiterminal support during system 
generation. 


The system generation procedure for specifying device support has 
changed. Instead of asking if you want support for each device 
individually, the system generation dialog repeats one question to ask 
you to list all the devices you want to support. If you type a question 
mark (?) followed by a carriage return, the system lists the codes for 
all the devices you can support and marks each device for which you have 
already included support with an asterisk (*). The system asks 
appropriate questions about support for additional controllers and CSR 
and vector addresses, as you select each device. 
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You can also specify your own device handlers during the 
generated. 
@ You can specify physical or logical device names for the devices 


process. 


@ The clock for the Professional 300 series works differently from a 
PDP-11 line clock. However, RI-11 supports the Professional clock in a 
mode similar to a 60 hertz line clock. Therefore, regardless of whether 
you choose 50 or 60 hertz during system generation, if you are running 


on a Professional computer, a 60 hertz clock rate will be used. 


@ Optimized PDT execution can be included by setting the conditional 
PDTSOP to 1. However, monitors generated with PDTSOP will not run on 
processors with programmable baud interfaces (DLARTS) or on 


SBC-11/21. 


1.5.7.2 New System Generation Options - The system generation dialog includes 


questions to generate support for the following options: 

e Host initiated bad-block replacement by DU bender 

e DU multiple port booting 

@e High-speed ring buffer 

@ Up to 9600 baud for DZ11 and DZV11 lines 

e User command linkage 

@ Fetchable handlers under XM 

@ Global .SCCA support 

@e Exclusion of Professional printer port support from LS handler 

@e Generation of support for the following additional devices: 
TIMSCP magtapes (MU) - TK50 
Ethernet handlers (NC, NQ, and NU) 
TSV05/TSU05 magtape (MS) 


MSCP disks (DU) - RA80/RA81, RC25, RD31, RD32, RD51, RD52, 
RD54, RX33, and RX50 


Professional 325, 350, and 380 devices: RD50, RD31, RD32, 
RD52 (DW), and RX50 (DZ) 


system 
generation procedure. They will be included in the build command files 


to be 
used for building your system at the end of the system generation 


the 
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SP transparent spooler handler 
XL communication package handler (PDP-11 and PDT=-11/150) 


XC communication package handler (Professional 300 series) 


1.5.8 New Procedures to Back up Distribution to Magtapes 


The following sections describe the procedures you use to back up the RT-11 
distribution to 800 bits/in, 1600 bits/in, or TK50 magtape. 


1.5.8.1 Backing up Distribution to 800 bits/in or 1600 bits/in Magtape - If you 
install a system distributed on magtape to run on hard disk, use the indirect 
command file MTB.COM or MSB.COM to preserve the distribution magtapes. (If your 
system is distributed on TK50 magtape, see Section 1.5.8.2.) 


Use MTB.COM if your magtape is written at 800 bits/in. Use MSB.COM if your 
magtape is written at 1600 bits/in. MTB.COM or MSB.COM replaces DISMT1.COM and 
DISMT2.COM. 


The indirect command files simplify the backup procedure. You no longer have to 
run a complete backup procedure for each magtape. Using MTB.COM or MSB.COM lets 
you run one indirect command file and switch magtapes in the middle of the 
procedure. 


To use MTB.COM or MSB.COM: 


Follow the directions in Section 8.1 of the R7-11 Installation Guide to 
bootstrap the first distribution magtape. Then, after you copy the files from 
distribution magtape 1 to the disk, replace distribution magtape 1 with 
distribution magtape 2. Copy all the files from distribution magtape 2 to the 
disk as well. Remove distribution magtape 2 from the tape drive. Reboot the 
disk. 


Complete the following steps to preserve the distribution magtapes. (These four 
steps replace the six steps in Section 8.2 of the RT-11 Installation Guide.) 


1. Mount a blank magtape in the tape drive. Leave the write ring in the 
back of the reel and make sure that the tape is positioned at the load 
point. 


2. Copy from the disk to your blank magtape those files that were on 
distribution magtape 1. To copy those files, invoke the indirect 
command file MTB.COM if your magtape is 9-track, 800 bits/in. If your 
magtape is 9-track, 1600 bits/in, invoke MSB.COM. (The commands you 
enter are shown below.) 


MTB.COM or MSB.COM initializes the blank magtape, writes the primary 
bootstrap on it, and copies a duplicate of distribution magtape 1. 
Before you invoke this indirect command file, use the ASSIGN command to 
assign the logical name BIN: to your disk device and the logical name 
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KIT: to your tape drive. In the commands, xx is MT, MS or MM, and yy 
is your disk. 


If your magtape is written at 800 bits/in, enter: 
. ASSIGN xxn: KIT:<RET> 


. ASSIGN yyn: BIN:<RET> 
_ SQ@MTB<RET> 


If your magtape is written at 1600 bits/in, enter: 
. ASSIGN xxn: KIT:<RET> 
. ASSIGN yyn: BIN:<RET> 
. S@MSB<RET> 
(The commands in the indirect file appear on the terminal.) 
3. Replace the backup magtape with a blank magtape. When MTB.COM or 
MSB.COM finishes copying files to the first magtape, it prints the 


following question on the terminal: 


xxn:/Initialize; Are you sure? 


Before you type a response, rewind the newly created backup magtape, 


remove it, write-protect it by removing the ring, and label it "Backup 
Roi Vos. 4p 1/2” 


Then, mount another blank magtape, leaving the write ring in the back 
of the reel. Make sure that the tape is positioned at the load point. 


4. Copy from the disk to the blank magtape those files that were on 
distribution magtape 2. 


Type a Y<RET> in response to the "Initialize; Are you sure?" question 
on the terminal. 


MTB.COM or MSB.COM initializes the blank magtape and copies a duplicate 
of distribution magtape 2. When the indirect command file finishes 
executing, the monitor prompt (.) appears on your terminal. Rewind the 
newly created backup magtape, remove it, write-protect it by removing 
the wring, and label it "Backup RT=-11-V05: 4p 2/72". 


Store the distribution magtapes. 


1.5.8.2 Backing up Distribution to TK50 Magtape - If you install a system 
distributed on TK50 magtape to run on hard disk, use the indirect command file 
MUB.COM to preserve the distribution TK50 magtape. 


To use MUB.COM: 
Follow the directions in Section 8.1 of the RT-11 Installation Guide to 


bootstrap the distribution TK50 magtape. Copy the files from the distribution 
TK50 magtape to the disk. Reboot the disk. 


(* 
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Complete the following steps to preserve the distribution TK50 magtape. (These 
three steps replace the six steps in Section 8.2 of the RT-11 Installation 
Guide.) 


1. Slide the write-protect switch on the front of a blank TK50 cartridge 
to the right to enable writing on the tape. Insert and load the blank 
TK50 magtape cartridge in the tape drive. 


2. When the TK50 magtape cartridge is loaded, invoke the indirect command 
file MUB.COM to copy the files from the disk to your blank TK50 
magtape. MUB.COM initializes the blank TK50 magtape, writes the 
primary bootstrap on it, and copies files in their correct order from 
the disk to the TK50 magtape. Before you invoke MUB.COM, use the 
ASSIGN command to assign the logical name BIN: to your disk device and 
the logical name KIT: to your tape drive. In the following commands, 
yy is your disk. 


. ASSIGN MUn: KIT:<RET> 
. ASSIGN yyn: BIN:<RET> 
. S@MUB<RET> 
(The commands in the indirect file appear on the terminal.) 
3. When MUB.COM finishes executing, the monitor prompt (.) appears on your 
terminal. Rewind the newly created backup TK50 magtape, remove it, 
write-protect it, and label it "Backup RT-11 V05.4D 1/1". 


Store the distribution TK50 magtape. 


1.5.9 New Procedures to Create a Bootable Magtape 


MTB.COM, MSB.COM, and MUB.COM are procedures that let you create a bootable 
magtape while you run RT-11 from a disk. 


Use MTB.COM if your magtape is to be written at 800 bits/in. Use MSB.COM if 
your magtape is to be written at 1600 pe Section 1.5.9.1 describes using 
MTB.COM and MSB.COM. 


Use MUB.COM if your magtape is a TK50. Section 1.5.9.2 describes using MUB.COM. 


1.5.9.1 Creating an 800 bits/in or 1600 bits/in Bootable Magtape - To use 
MTB.COM or MSB.COM: 


1. Mount a blank magtape in the tape drive. Make sure that the magtape is 
write enabled and on line. 


2. Invoke the indirect command file MTB.COM or MSB.COM. (The commands you 
enter are shown below.) 
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MTB.COM or MSB.COM initializes the blank magtape, writes the primary 
bootstrap on it, and copies files in their correct order from the disk 
to the magtape. Before you invoke the indirect command file, use the 
ASSIGN command to assign the logical name BIN: to your disk device and 
the logical name KIT: to your tape drive. In the commands, xx is MT, 
MS, or MM, and yy is your disk. 


If your magtape is written at 800 bits/in, enter: 


, ASSIGN xxn: KRIT?s<RETO 
. ASSIGN yyn: BIN:<RET> 
_ SQ@MTB<RET> 


If your magtape is written at 1600 bits/in, enter: 


_ BSoIGN zens KIT: <RET>O 
, ASSIGN yyn: BIN:<RET> 
_ $@MSB<RET> 


(The commands in the indirect file appear on the terminal.) 


Replace the magtape in the tape drive with a blank magtape. When 
MTB.COM or MSB.COM finishes copying files to the first magtape, it 
prints the following question on the terminal: 


xxn:/Initialize; Are you sure? 


Before you type a response, rewind the newly created bootable magtape, 
remove it, write-protect it by removing the ring, and label it "RT-11 
VOUS. 40 Ly 2". 


Then, mount another blank magtape, making sure that it is write enabled 
and on line. 


Type a Y<RET> in response to the "Initialize; Are you sure?" question 
on the terminal. MTB.COM or MSB.COM initializes the blank magtape and 
copies the remaining files in their correct order from the disk to the 


magtape. 


When the indirect command file finishes executing, the monitor prompt 
(.) appears on your terminal. Rewind the newly created magtape, remove 
it, write-protect it by removing the ring, and label it "RT~-11 V05.4D 
Bia, 


Creating a Bootable TK50 Magtape - To use MUB.COM: 


Slide the write-protect switch on the front of a blank TK50 cartridge 
to the right to enable writing on the tape. Insert and load the blank 
TK50 magtape cartridge in the tape drive. 


When the TK50 magtape cartridge is loaded, invoke the indirect command 
file MUB.COM to copy the files from the disk to your blank TK50 
magtape. MUB.COM initializes the blank TK50 magtape, writes the 
primary bootstrap on it, and copies a duplicate of the distribution 
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TK50 magtape. Before you invoke MUB.COM, use the ASSIGN command to 
assign the logical name BIN: to your disk device and the logical name 
KIT: to your tape drive. In the following commands, yy is your disk. 


- ASSIGN MUn: KIT:<RET> 
- ASSIGN yyn: BIN:<RET> 
- S$@MUB<RET> 


(The commands in the indirect file appear on the terminal.) 


3. When MUB.COM finishes executing, the monitor prompt (.) appears on your 
terminal. Rewind the newly created bootable TK50 magtape, remove it, 
write=protect it, and label it "RT=11 V05.4D 1/1". 


1.5.10 New Error Messages 
Error messages have been added for the following software components: 


BATCH (job control utility) 

BUP (backup utility) 

DUP (device utility program) 

FORMAT (formatting utility) 

IND (indirect control file processor) 
KMON (keyboard monitor) 

LD (logical disk subsetting facility) 
LINK (linker utility) 

MDUP (magtape utility program) 

PIP (peripheral interchange program) 
PRO/GIDIS (graphics utility) 

SETUP (hardware setup utility) 

SL (single-line editor) 

SPOOL (transparent spooling utility) 
SYSGEN (system generation procedure) 
TRANSF (VTCOM file transfer program) 
UCL (user command linkage utility) 
VTCOM (virtual terminal communication package) 


Error messages for RT-1l1 V5.4 are in Section A.1. Error messages for RT-11 V5.3 
are in Section A.2. 


1.5.11 New Software Update Process 


To maintain RT-11 and layered product software, you no longer need to install 
mandatory patches. Instead, RT-11 V5 provides an update process that replaces 
the software modules that have been changed. 


Update kits are distributed periodically after RT-11 is released. Each update 
kit includes an automatic procedure for replacing software modules with the 
replacement software modules. The update procedure guides you through an 
interactive dialog to determine which products you want to update and which 
devices you are using. Then the update software performs the module replacement 
operations. 
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Instead of providing binary patches, the RT-11 Software Dispatch now contains 
only articles describing problems corrected and functionality added by the 
update kits. 


Source kits are still available. 


1.5.12 New Unsupported Utilities 


The following unsupported utilities are included with RT-11. See the Preface to 
this manual for a definition of the meaning of the term unsupported as it 
applies to unsupported utilities. 


1.5.12.1 INDEX On-line Index Package - RT-11 V5.4B includes a new on-line index 
program, INDEX, that displays on your terminal screen most of the entries 
contained in the RT-11 Master Index. INDEX entries are taken directly from the 
index files used to create the RT-11 Master Index. INDEX also contains entries 
for the RT-11l System Release Notes and the on-line release notes file, 
V5NOTE.TXT, that are not included in the RT-11 Master Index. The entries for 
INDEX are updated for each release of RT-1l. Therefore, INDEX is your best 
source for the latest information in the RT-11 documentation. 


The INDEX package consists of three files: 


INDEX. IDX 1S an index-pointer (an index of the index) 
INDEX. IMG is the index file 
INDEX. SAV is the INDEX program 


You can run INDEX as the background job, the foreground job, or as a system job. 
The files in the INDEX package can be on your system (SY) and/or data (DK) 
device. 


When you run INDEX, it displays an introductory frame on your’ screen. That 
frame displays the mnemonics for the manuals in the RT-11 documentation set that 
are contained in the index. Manuals not listed in the introductory frame are 
not included in the index. 


Of those manuals listed, only the device-specific installation information 
(Chapters 3 through 11) of the RT-11 Installation Guide (INST) and the actual 
commands and options in the RI-11 System User’s Guide (SUG) are not included in 
the index. (It 1S assumed that you have installed your system before you 
require the on-line index, and the commands and options in the SUG are 
alphabetically listed.) Installation and command information appearing elsewhere 
in the RT-11 documentation is indexed. 


Press RETURN to enter the index. Type as short an unambiguous search string as 
possible and press RETURN. INDEX displays any entries matching the string. 
Continue to press RETURN to scroll through the index or type another search 
string and press RETURN. 


Type CTRL/C to exit from INDEX. 
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1.5.12.2 MSCPCK.SAV TMSCP Controller Checking Program - MSCPCK.SAV checks your 
TMSCP (MU) device controller (if present) and reports its revision level by 
displaying the following message: 


2MSCPCK-I-MUx-FW Rev Level is nnn/HW Rev Level is nnn 


where x is the MU unit number and nnn is a 3-digit firmware or hardware 
revision level. 


A command to run MSCPCK is included and enabled in the start-up command files 
for all monitors (except STARTA.COM). If your configuration includes a TMSCP 
device, be sure that MSCPCK.SAV resides on your system volume. If your 
configuration does not include a TMSCP device, you can disable the command to 
run MSCPCK in your start-up command file by editing that file and placing an 
exclamation point (!) before the command (!R MSCPCK). 


MSCPCK.SAV checks the TQK50 Q-bus controller for its rev level. If the TQK50 
controller is below rev level, the MU handler installs and MSCPCK.SAV returns 
the error message, ?MSCPCK-W-TQK50 controller below FW Rev 4/HW Rev 6. If you 
receive that message, contact your local DIGITAL field service representative. 
Reliable TK50 operation on Q-bus processors reguires a controller of at least 
firmware revision 4 and hardware revision 6. 


1.5.12.3 DBG-11 Symbolic Debugging Package - An unsupported debugging package 
for MACRO-11 programs, DBG-11, has been added to the RT-11 distribution kit. 
See the DBG-11 Symbolic Debugger User’s Guide for complete information. 


1.5.12.4 TRANSFER - An unsupported utility, TRANSFER, has been added to the 
RT-11 distribution kit. See Chapter 5 for complete information. 


See the RT-11 System Utilities Manual for a description of other unsupported 
utilities and instructions on how to use them. 


1.6 NEW DOCUMENTATION 


Two RT-11 V4 manuals, the RT-11 System User’s Guide and the RY-1l1 Installation 
and System Generation Guide, have each been split into two manuals to achieve a 
more modular documentation set. The RT-11 V5 documentation set also includes 
three additional manuals, as well as additions to V4 manuals and changes in the 
documentation format. The following sections describe the additional and 
changed V5 manuals. 


1.6.1 DBG-11 Symbolic Debugger User’s Guide 


The DBG-11 Symbolic Debugger User’s Guide tells you how to use the DBG-11 
symbolic debugging package with RT-11 to debug your MACRO-11 programs. 
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1.6.2 RY-11 for Beginners 


RT-11 for Beginners assumes that you do not have any experience with computers. 
The manual tells you how to _ start the RT-11 operating system, how to use a 
subset of RT-11 commands to perform common operations, and how to use the keypad 
editor to create and edit text files. A quick reference to a subset of RT-11 
commands and options is included. The manual also lists a subset of RT-11 
system messages, a brief explanation of each message, and suggestions for 
correcting errors. 


1.6.3 RY-11 Automatic Installation Booklets 


The RT-11 automatic installation booklets are new to the RT-11 documentation 
set. Each booklet provides instructions for starting the software that 
automatically installs RT-11. Your RT-11 documentation includes the booklet 
appropriate for your distribution media, if your media supports automatic 
distribution: 


RT-11 Automatic Installation Booklet, TK50 Magtape 

RT-11 Automatic Installation Booklet, RX02 Diskettes 

RT-11 Automatic Installation Booklet, RLO2 Disk 

RT-11 Automatic Installation Booklet, MicroPDP-11 (RX50 distribution) 


RT-11 Automatic Installation Booklet, Professional 300 Series (RxX50 
distribution) 


1.6.4 RT-11 Mini-Reference Manual 


This new RT-11 manual provides condensed reference information in a_ small, 
portable loose-leaf binder. The RT-11 Mini-Reference Manual covers keyboard 
commands, utility programs, programmed requests, SYSLIB routines, and monitor 
fixed offsets. This manual replaces the RT-11 V4 RT-11 Pocket Guide and 
contains information from the programmed request section of the  RT-1l1 
Programmer’s Reference Manual as well as information from the RT-11 Pocket 
Guide. 


1.6.5 RYf-11 Update User’s Guide 


This manual, which you receive with your update kit, describes how to use the 
new RI-1l update process to maintain your software. You can store your RI-11 
Update User’s Guide in Volume 1 of your RT-11 binder set. 
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1.6.6 Guide to RI-11 Documentation 


This manual, which replaces the V4 R7T-11 Documentation Directory, summarizes 
each manual in the RT-11 documentation set and suggests appropriate reading 
paths for different users. 


1.6.7 RT-11 System User’s Guide 


The V5 RT-11 System User’s Guide describes the RT-11 operating system, system 
conventions, keyboard monitor commands, and the text editor EDIT. This manual 
contains the information in Chapters 1 through 5 of the V4 RT-11 System User’s 
Guide and provides a new chapter on the indirect control file processor (IND). 


1.6.8 RTI-11 System Utilities Manual 


This new manual, which describes the RT-11 utility programs, presents the 
information from Chapters 6 through 24 of the V4 RT-1l1 System User’s Guide. 
This manual also includes chapters on the new backup utility program (BUP) and 
logical disk subsetting program (LD). 


1.6.9 RT-11 Installation Guide 


The RT-11 Installation Guide describes manual procedures for installing RT-11; 
it also tells you how to customize the distributed RT-11 software. This 
document contains the information in Chapters 1 through 7 of the V4 R&T-11 
Installation and System Generation Guide. Two chapters have been added to 
describe installing RT-11 on diskettes from a hard disk distribution kit and 
installing RT-11 on a MicroPDP-11. Information has also been added to Chapter 5 
to describe installing RT-11, using RC25 disks. 


1.6.10 RY-11 System Generation Guide 


This manual, taken from Chapters 8 through 10 of the V4 RT-11 Installation and 
System Generation Guide, tells you how to run the system generation software to 
produce monitors and handlers with specialized configurations and 
characteristics. 


1.6.11  PDP-11 TECO User’s Guide 


Since TECO software has been removed from the RT-11 distribution kit, the PDP-11 
TECO User’s Guide has been removed from the documentation set. 


CHAPTER 2 


CHANGES AND ADDITIONS TO EXISTING COMPONENTS 


This chapter describes features that have been added to existing RT-11 software 
components, new information about existing features, and features that have been 
changed. 


You can use the on-line index utility, INDEX, to find more information on topics 
described in this chapter. 


2.1 DISTRIBUTION KIT 

Changes have been made to the RT-11 software distribution kit for V5.4. 

Sources for all supported and unsupported components except MACRO, CREF, the 
DBG-11 handlers, DBGSYM.SAV, and GIDIS are provided on the RT-11 distribution 
source kit. The distributed files TRANSF.EXE, TRANSF.TSK, and KED.SAV 
(including its variants) cannot be built from the source files, using only 
1a i Oe 

The KED, KEX, and K52 sources are now provided on the source distribution kit. 


Software kit maps are no longer included in this document; they are now included 
with the binary distribution kit cover letter. 


2.1.1 New Files 


The following files have been added to the RT-11 V5.4 software distribution kit: 


DBGSYM. SAV DBG-11 symbol definition utility (unsupported) 

INDEX. IDX The index pointer (index of the index) for the INDEX on-line 
index utility 

INDEX. IMG The index file for the INDEX utility 

INDEX. SAV The on-line index utility, INDEX (unsupported) 


MDUP .AI Bootstrap utility for TMSCP magtape automatic installation 


en 


MDUP .MU 


MSB .COM 


MSCPCK. SAV 


MU.SYS 


MUB .COM 


MUX.SYS 


NU.MAC 


NUX.SYS 


SDH.SYS 


SDHX.SYS 


SDS.SYS 


SDSX.SYS 


TU.MAC 


UM.MAC 
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Bootstrap utility for TMSCP magtape manual installation 


Indirect command file used to build distribution backup 
magtape from distributed 1600 bits/inch magtape 


Checks TMSCP (MU) device controller (if present) and reports 
that controller’s revision level 


TMSCP handler for SJ and FB monitors 


Indirect command file used to build distribution backup 
magtape from distributed TK50 magtape 


TMSCP handler for XM monitor 
DEUNA handler source file for system generation 
DEUNA handler for XM monitor 


DBG-11 hardware I/O handler for SJ and FB monitors 
(unsupported) 


DBG-11 hardware I/O handler for XM monitor (unsupported) 


DBG-11 software I/O handler for SJ and FB monitors 
(unsupported) 


DBG-11 software I/O handler for XM monitor (unsupported) 
TMSCP handler source file for system generation 


MSCP class handler source code file required for MTMSCP 
device handler system generation 


Use the new on-line index, INDEX, to find the latest information about topics 
related to new files. 


2.2 MONITORS 


This section contains new information, features, additions, or changes to the 


RT-11 monitors. 


@® KMON accepts numeric job names - Job names specified using the 


/NAME : name 


option can be numeric. For example, the following commands 


run VICOM as a system job and assign it the name 6. All further 


references 


to VICOM must use the name 6, and that name assignment 


remains in effect until you reboot your system. 
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. SRUN SY: VICOM.SAV/NAME:6/PAUSE 
LOAD XC=6 
RESUME 6 


You would then specify 6 in response to the system job prompt (JOB>) to 
call VTCOM. The SHOW JOBS command would display the job 6. 


BSTRAP no longer ignores set carry bit from system device handler load 
routine - Previously, the bootstrap ignored the carry bit when the 
handler load routine refused to load the system device handler. The 
bootstrap returned no error message and the system halted. For RT-11 
v5.4C, the bootstrap returns an error message if the system device 
handler refuses to load, andthe system halts. For processors other 
than the Professional 300 series, that error message is, ?BOOT-U-Failure 
to load system handler. For Professional 300 series processors, the 
error code displayed on the console terminal is 000013. 


Abort code passed from RMON to the handler abort entry point has been 
modified for RT-11 V5.4 - Job channel abort information is now passed 
to the handler in Rd. Therefore, you should modify any internally 
queued handler you have written to correctly process the information 
passed by R5 in the following manner: 


The contents of R5 now determine the type of abort; whether a handler 
aborts all queue elements for a job or only those queue elements on a 
particular channel. When R5 contains zero, the handler should abort all 
queue elements for the job number matching R4. When R5 is nonzero, it 
points to the first word of a channel control block (the channel status 
word), and the handler should abort only the queue elements for that 
channel. 


KMON passes unaltered commands - KMON by default now passes unaltered 
commands by means of the chain area. This is useful for programs that 
require command input that is not a file specification (such as SETUP 
commands) . Only RUN filename constructions are valid; that is, RUN 
filename, RUN filename data, and CCL (concise command language) 
constructions. 


An optional third argument for the GTLIN subroutine supports a program 
getting the unaltered command line. See the RT-11 Programmer’s 
Reference Manual for information. 


KMON preprocessor interface (UCF) - You can create a KMON preprocessor 
(UCF) that intercepts all command line input after KMON has tried IND 
command syntax. UCF can be used to process valid DCL commands in a way 
you choose, rather than the way KMON would normally process the 
commands. UCF can also be used to process commands that KMON would 
otherwise refuse. See the RIT-11 Software Support Manual for 
information. 


The distributed file UCL.SAV can be copied and renamed to create a 
functional UCF.SAV. See the RI-1l System User’s Guide for information. 
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e KMON command line processor customization patch - A customization patch 


lets you selectively inhibit the various (DCL, CCL, UCL) KMON command 
line processors. See Section 2.7.63 in the R7T-11 Installation Guide for 
information. 


KMON no longer automatically converts lowercase input to 
uppercase - KMON no longer automatically converts lowercase characters 
to uppercase from both terminal input and command files. A program 


using .GTLIN with the lowercase bit set receives the commands in 
lowercase if entered in lowercase. However, when type-ahead is used, 
characters are sometimes transmitted and echoed as uppercase no matter 
what case is entered at the keyboard. 


See Chapter 2 in the R7-11 Software Support Manual for information. 


Minimum memory requirement - The minimum memory requirement has been 
increased to 16K words for the SJ monitor and to 24K words for the FB 
monitor. The minimum memory requirement for the XM monitor (32K words) 
remains the same as in RT-11 V4. 


Default working monitor - FB is the default monitor for a working system 
installed through RT-11 automatic installation procedures for all 
processors except the Professional 300 series. The XM monitor is 
installed on the Professional 300 series during automatic installation. 
If your system does not include the minimum hardware requirements for 
the FB monitor (24K words of memory and a line-time or Professional 
series clock), you cannot perform the automatic installation procedure. 
See Chapter 4 for information on how to install your system when your 
hardware configuration does not support automatic installation. 


Distributed XM monitor - Under RT-11 V4, use of the extended memory 
feature was available only through system generation. The RT-11 V5 
distribution kit includes an XM monitor, RT11XM.SYS. The -#r=ii 
Installation Guide describes all the features included in the 
distributed XM monitor. The most notable features include device 
timeout support and system job support. 


BATCH excluded from distributed monitors - BATCH support is excluded 
from the distributed monitors. BATCH support is available only through 
system generation. 


FPU support included in distributed monitors - FPU support is included 
in the distributed SJ, FB, and XM monitors. 


Monitor fixed offsets - The following monitor fixed offsets have been 
added to the resident monitor data base: 


SPSTAT Word offset 414; SPOOL status word (formerly reserved for 
DECnet) 


EXTIND Byte offset 416; the stored error byte for IND 


INDSTA Byte offset 417; the IND control status byte 
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SMEMSZ 


STCFIG 


SINDDV 


MEMPTR 


PIEXT 


IMPLOC 


KMONIN 


PROGDF 
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Word offset 420; contains the total amount of memory available 
(in 32-word blocks) to the monitor currently executing 


Word offset 424; contains the address of the current console 
configuration word (SET option status); points to TTCNFG in 
Single terminal systems and T.CNFG in the current console’s 
terminal control block (TCB) in multiterminal systems 


Word offset 426; pointer to INDDEV (the ASCII device name and 
unit number from which IND will be run) 


Word offset 430; contains the offset to memory control block 
pointers 


Word offset 432; contains the address of the kernel PARI 
externalization routine for fetchable handlers under the XM 
monitor; contains the value 0 when running under the SJ or FB 
monitor 


Word offset 444 1s reserved 


Word offset 446; under the SJ monitor, IMPLOC contains a value 
of 0. Under the FB and XM monitors, IMPLOC contains a pointer 
to word following last word in table of pointers to the impure 
area 


Under FB and XM monitors, IMPLOC-2 contains a pointer to the 
foreground job impure area if a foreground job is loaded, or a 
0 if no foreground job is loaded 


The last word in the table of pointers to impure areas 
contains -1l. The word above the word containing -1 is the 
pointer to the background job impure area. The pointers to 
the impure area for any system jobs supported by the monitor 
are located between the pointers to the foreground and 
background impure areas 


Word offset 450; indicates if KMON is the background job. If 
KMONIN contains nonzero value, then KMON is background job; if 
KMONIN contains zero, then KMON not background job 


Byte offset 452; indicates default editor for EDIT command. 
The values in PROGDF that indicate the default editor are: 


Value Default Editor Is: 


20> KED 
223 K52 
224 KEX 
225 EDIT 
226 TECO 


CHANGES AND ADDITIONS TO EXISTING COMPONENTS 


Byte offset 453 is reserved 


WILDDF Byte offset 454; indicates if wildcards (*) are implicit or ig 
must be supplied explicitly. A value of one indicates 
implicit wildcarding; zero indicates explicit wildcarding 


Byte offset 455 is reserved 
Fixed offset 474 is defined as Reserved. 


See Section 3.6.1 in the RT-11 Software Support Manual for more 
information on monitor fixed offsets. 


Monitor floating offsets - The following monitor floating offsets have 
been added to the resident monitor data base: 


Cioxe High byte of word located one word below INDDEV (see SINDDV 
word offset 426 in this section); indicates which command 
processor 1S running 


CLIFLG Low byte of word located one word below INDDEV (see SINDDV 
word offset 426 in this section); indicates which command 
processors can be run 


Bit definitions - The following bit masks are defined for fixed offset 
locations: 


Offset Bit Mask Meaning 
CONFG2 LDRELS = 20 A handler has been unloaded or released. baad 
BUSS = 100 O= Rill. 2S ‘timning on UNIBUS oz 


Professional (CTI-BUS) machine. 
If PROSS = 0, then UNIBUS machine. 


If PROSS = 1, then CTI-BUS machine. 


1 = RT-11 is running on Q-bus machine. J 
PROSS = 20000 0 = RT-11 is not running on Professional 
300 series system. 
1 = RT-11 iS running on Professional 300 
series system. 
INDSTA CCSIND = 4 Status of .ENABLE/.DISABLE ABORT. 
CCSGBL = 10 Status of global .SCCA. 
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LNSIND = 40 Indicates current line from IND. 
INSRUN = 100 KMON has issued a RUN IND command. 
INSIND = 200 IND has returned control to KMON. 
SYSGEN FPU11$ = 400 Indicates that FPU support has been chosen 


as a system generation option. 


TSXP$ = 100000 Reserved for TSX PLUS*. This bit should 
never be set under RT-11. 


*TSX-PLUS is a trademark of S & H Computer 
Systems, Inc. 


_ SPSTAT NEXT = 10 Move to start of next file. 
OFF = 20 Set spooler unit off. 
ON = 40 Set spooler unit on. 
KILL = 100 Remove spooled output from work file. 
ACTIVE = 200 Indicates spooler is active. 
SHOW = 4000 Display spooler status. 


PRTSCR = 10000 Print screen (Professional 300 series 
only) . 


DATIME = 20000 Date and time request (for flag pages). 
INTEN = 40000 # Fake interrupt enable. 
ERROR = 100000 Error bit (set by SPOOL). 


See Section 3.6 in the RY-11 Software Support Manual for more 
information on fixed offset bit masks. 


Support for 22-bit addressing (on Q-bus and CTI-bus processors 
only) - The XM monitor now supports 22-bit addressing to let each job 
(up to eight with system job support) have a program logical address 
space (PLAS) limited only by available memory, using virtual overlays 
and/or virtual .SETTOP. The job PLAS may be up to 4M bytes (minus 64K 
bytes RT-11 overhead), using explicit programmed requests. 


All monitors also support up to 4M bytes of memory through the VM 
handler, which treats memory above 28K words as though it were a random 
access device. 
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When using the XM monitor on any 22-bit system, 22-bit addressing will 
be enabled. However, since RTI-11 does not support the UNIBUS map 
hardware, memory above 256K bytes cannot be used for direct memory 
access (DMA) I/O on UNIBUS processors. Any attempt to do so will return 
a hard error from the device handler. To avoid this situation, the VM 
handler may be installed such that its base is at the 18-bit/22-bit 
boundary (SET VM BASE=10000). No such restrictions apply to Q-bus 
systems. 


See Chapter 4 of the RT-11 Software Support Manual for more information 
on 22-bit addressing. 


@ KMON size - The size of the keyboard monitor (KMON) for SJ has been 
increased to 20000(octal) bytes. In RT-11 V4, KMON was 17000 (octal) 


bytes. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to RT-11 monitors. 


2.3 KEYBOARD MONITOR COMMANDS 
This section summarizes the changes to existing keyboard monitor commands and 


describes the new keyboard monitor commands. For details on these changes and 
new features, see Chapter 4 in the RI-11 System User’s Guide. 


2.3.1 Changed Keyboard Monitor Commands and Options 


The following keyboard monitor commands and options have changed. 


2.3.1.1 Commands 

BASIC BASIC has been removed from the list of keyboard commands. To 
run BASIC, you must now type the word BASIC (rather than the 
abbreviation BAS), then a carriage return: 

. BASIC<RET> 

COMPILE The /BUFFERING option has been eliminated. 
The /PASS:1 option has been eliminated. 

COPY When you use the /DELETE option with the COPY command, you are no 
longer prompted for confirmation of the deletion. If you want 
this prompt, you must now use the /QUERY option. 

When you copy files, the protection status of the output file 


will be the same as the protection status of the input file, 
unless you use the /PROTECTION or /NOPROTECTION option. 
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DELETE 


DIBOL 


DIFFERENCES 


DIRECTORY 


EXECUTE 
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The /SETDATE option now accepts an optional date argument. When 
you specify /SETDATE[:date], the system puts the specified date 
on all files you copy. 


You no longer need to use the /SYSTEM option to copy .SYS files 
unless you use wildcards in the input file type. 


You can now use the /VERIFY option for files as well as for 
entire volumes. The /VERIFY option is invalid with the /ASCII 
and /BINARY options. 


You can now use the /WAIT option with the /DOS and /INTERCHANGE 
options. 


The DELETE command no longer prompts you for confirmation, unless 
you use wildcards in the file specification. 


You no longer need to use the /SYSTEM option to delete .SYS files 
unless you use wildcards in the input file type. 


You can now use the /WAIT option with the /DOS and /INTERCHANGE 
options. 


The /BUFFERING option has been eliminated. 


The DIFFERENCES command now accepts wildcards to let you compare 
several files with one command. See Chapter 4 of the RT-11 
System User’s Guide for more details on using wildcards with the 
DIFFERENCES command. 


The /SLP option now accepts a file specification argument. When 
you specify /SLP:filespec, you can later use the resulting file 
you specify as input to SLIP. You can also use the 
/OUTPUT:filespec option in the same command line to produce a 
differences listing and an SLP command file simultaneously. ita 
you use the /OUTPUT:filespec option without the /SLP:filespec 
option, a differences listing is generated and the SLP command 
file is printed on the console. In RT-11 V4, you had to use 
/OUTPUT:filespec with /SLP to specify a command file; you could 
not produce a differences listing and a command file 
Simultaneously. 


The /BEGIN option is now position independent. The command 
DIRECTORY/BEGIN is now valid. 


You can now use the /WAIT option with the /DOS and /INTERCHANGE 
options. 


You can also now use the  /VOLUMEID[:ONLY] option with 
/INTERCHANGE to print the volume ID of an interchange diskette. 


The /BUFFERING option has been eliminated. 
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FORMAT 


INITIALIZE 


MACRO 


PRINT 


RENAME 


REMOVE 


RESET 
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The /PASS:1 option has been eliminated. 


You can now format volumes while a foreground job is loaded or 
when the volume to be formatted contains protected files. If you 
try such an operation, the system gives you a warning message, 
then asks you whether you want to continue the operation. 


The table of verification patterns valid for the /PATTERN option 
has been increased to 16 patterns. The last 4 of the 16 patterns 
are reserved for future use. 


You can now use the /VOLUMEID[:ONLY] option with the /INTERCHANGE 
option to write a volume identification on an interchange 
diskette. 


The /PASS:1 option has been eliminated. 


The PRINT command is affected when both QUEUE and SPOOL are 
running. KMON assigns precedence to SPOOL for any PRINT command, 
so take care if you run both QUEUE and SPOOL. PRINT options 
/PROMPT and /NAME are specific only to QUEUE. If both QUEUE and 
SPOOL are running, KMON treats those PRINT options as assigned to 
SPOOL, and returns an invalid option error. 


When SPOOL or both SPOOL and QUEUE are running, the /FLAGPAGE:n 
option, when a value is specified for n, overrides the SET SP 
FLAG=n command. When no value is specified for n with the 
/FLAGPAGE:n option, the value for n is set by the SET SP FLAG=n 
command. The /NOFLAGPAGE option inhibits flag pages under all 
circumstances. 


When only the QUEUE package is running, the default number of 
banner pages printed when you use the /FLAGPAGE:n option is 
determined by the default number of banner pages set with the 
QUEMAN /P option. If the default set with the /P option is 0, 
the default for /FLAGPAGE:n is 1. If the QUEMAN /P option is not 
used, the default is /NOFLAGPAGE. 


The /SETDATE option now accepts an optional date argument. When 
you specify /SETDATE[:date], the system puts the specified date 
on all files you rename. 


You no longer need to use the /SYSTEM option to rename .SYS files 
unless you use wildcards in the input file type. 


When running under the XM monitor only, the REMOVE command can 
now be used to remove a global region from extended memory and 
return the memory allocated to that global region to the free 
memory list. 


The RESET command now resets the console terminal ring buffers 
and command buffers. 


t | 
eg 


SET 
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You can now execute virtual jobs from devices other than the 
system device. Therefore, you can use the RUN command to execute 
virtual jobs. 


SET command conditions are now individually parsed. As a result, 
you no longer need to enter a completely valid command for 
modifications to occur. For example, if a SET command specifies 
four condition modifications and the third condition is invalid, 
the first two conditions are modified and an error is returned 
when the third condition is parsed. All conditions following the 
invalid condition are not modified. Unless you know which 
condition is invalid, you should reenter the entire command to be 
sure all conditions are modified. 


The SCOPE option for TT is now the default for all monitors. 
The DUn [NO]WRITE options are eliminated. 


The DZ [NO]WRITE options are eliminated. because RX50 diskettes 
provide hardware write protection. 


You can now use SET TERM or SET Abell to set console 
characteristics. 


The SETUP [NO]CURSOR command now applies to VT200 _~ series 
terminals. 


SHOW SUBSET now displays any logical name assigned to a _ logical 
disk. For example, if you mount a 1000 block file DU4:F00.DSK on 
logical device unit LDO and assign it the name FOO, SHOW SUBSET 
now displays: 


LDO is DU4:FOO.DSK[1000.] = FOO 


SHOW DEVICES:DU displays additional DU status information. fThe 
port display now indicates an invalid port by displaying an 
asterisk (*) before the port number. For example, port = #*n, 
where n = 0,1,2,3, indicates that port n was not installed. If 
SHOW DEVICES:DU displays port = n, where n = 0,1,2,3, then port n 
1s installed (that is as documented). 


The SHOW command can now list the contents of the UCL data file, 
using the SHOW COMMANDS command. You can send output from SHOW 
COMMANDS to any RT-11 output device. The /PRINTER option sends 
output to the printer. The /OUTPUT:filespec option sends output 
to the specified file specification. The options are position 
dependent and must follow COMMANDS. For example, the command 
SHOW COMMANDS/PRINTER sends the contents of the UCL data file to 
your printer. The default output of SHOW COMMANDS is the console 
terminal. 


/PRINTER and /OUTPUT:filespec options are position dependent in 
the same manner when used with the SHOW ERRORS command. 
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The shortest valid abbreviation for COMMANDS is COM. 


The SHOW command now includes logical disk  subsetting 
assignments. 


The SHOW ALL command now displays the organization of physical 
memory and logical disk subsetting assignments. 


The SHOW ALL command now displays the region type in the extended 
memory map. 


The SHOW CONFIGURATION command now also displays the following 
system attributes: 


@ Total amount of memory 

@ Active command file processor: KMON or IND 

e SL status: on or off 

@ Default editor for EDIT command 

® Status of .SCCA support and the .SCCA flag when enabled. 
@® EAE (extended arithmetic element) hardware option 


The shortest valid abbreviation for CONFIGURATION is CON. Any 
indirect files that contain a shorter abbreviation must be 
updated. 


The SHOW DEVICES command lets you obtain information about a 
specific device by using the command SHOW DEVICES:xx. The 
variable xx represents the 2-letter permanent device name. The 
CSR and vectors for each device displayed are also given. 


The SHOW MEMORY command shows the location of each low memory 
component and, under the XM monitor, each extended memory region 
as well. 


SHOW MEMORY now displays a fourth column in the extended memory 
map that indicates the type of region being listed. 


The SHOW ERRORS command displays errors recorded by the error 
logger while running under the SJ monitor. 


The SHOW QUEUE command shows the contents of the queue for SPOOL 
or QUEUE, or for both if both are running. The SPOOL status 
report shows whether the SPOOL output device is active or 
inactive, the number of blocks spooled for output, and the number 
of free blocks in SPOOL’s work file. 
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SRUN 


TYPE 


2.3.1.2 /WAIT 
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The SHOW QUEUE command is now performed by the RESORC /Q option, 
rather than by the QUEMAN /L option. However, the QUEMAN /L 
option is still valid for compatibility. If the SPOOL utility is 
running, SHOW QUEUE requires RESORC.SAV be on device SY:. If the 
QUEUE utility is running, SHOW QUEUE requires RESORC.SAV and 
QUEMAN.SAV be on device SY:. 


The default file type for the SRUN command is .REL. The SRUN 
command now defaults to the system device (SY:). 


Executing a CTRL/O now stops the display of a file when multiple 
files are displayed at the terminal. Executing a CTRL/O discards 
output until another CTRL/O is executed, or until the beginning 
of the next file is reached, whereupon output to the terminal is 
resumed. 


Options 


You can now abort a /WAIT operation. See the following commands in the RT-11 
System User’s Guide for more information: 


BOOT 

LOPx 
DELETE 
DIRECTORY 
FORMAT 
INITIALIZE 
PRINT 
PROTECT 
RENAME 
SQUEEZE 
TYPE 
UNPROTECT 


2.3.2 New Keyboard Monitor Commands 


The following keyboard monitor commands are new. Options for these commands are 
listed in the RT-11 System User’s Guide. 


ABORT 


BACKUP 


DISMOUNT 


The ABORT command lets you abort, from the shared console, a 
foreground or system job assigned to a private console terminal 
with the FRUN or SRUN /TERMINAL:n option. The ABORT command 
cannot abort a job with SCCA in effect. 


The BACKUP command provides a quick means of backing up a file or 
an entire volume for storage. 


The DISMOUNT command is used for logical disk subsetting to 
dissociate a logical disk unit from the file to which it was 
assigned. 


MOUNT 
PROTECT 


RECALL 


UNPROTECT 
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The MOUNT command is used to associate a file with a logical disk 
unit for logical disk subsetting. 


The PROTECT command assigns a protection status that prevents 
deletion of a file until you remove the protection. 


The RECALL command requires that you be running the Single-Line 
Command Editor under the XM monitor. RECALL displays and 
retrieves commands you previously issued. Issuing the RECALL 
command with no option recalls the previous command. 


The RECALL command is described, with examples, in Appendix E. 


The UNPROTECT command removes protection from a file so you can 
delete it. 


2.3.3 New or Changed Keyboard Monitor Command Options 


This section contains new or changed options for old and new keyboard monitor 
commands. Descriptions for options not described here are in the R7T-11 System 


User’s Guide. 

BACKUP 
/DEVICE 
/FILE 


/INITIALIZE 


/ [NO] LOG 


/ [NO] QUERY 


/RESTORE 


/ [NO] REWIND 


Must be specified to initialize a magtape; is automatically 
included with disk operations. 


/NOLOG suppresses various informational messages BUP prints 
as backup operations are performed. The default operation 
is to display the messages (/LOG). 


/NOQUERY inhibits various responses otherwise required from 
the terminal. Allows using BUP from KMON command and IND 
control files to write a single disk or magtape output 
volume (MOUNT prompts require terminal response). /QUERY is 
the default. 


/NOREWIND with backup operations inhibits rewinding magtape 
before appending next saveset to that magtape. Increases 
the speed of backup operations but also omits saveset name 
verification (the magtape must rewind to check for unique 


Saveset names The default operation is to rewind the 
magtape befu.. appending the next saveset to that magtape 
(/REWIND) . 


/ [NO] SCAN 


/SAVESET 


/VERIFY 


/VERIFY : ONLY 


COMPILE 


/LOG 
/PAGE:n 
/ TABLES 


COPY 


/BEFORE [: date] 
/DATE[:date] 

/ INFORMATION 
/MULTIVOLUME 
/PROTECTION 
/NOPROTECTION 
/RETAIN 
/SINCE[:date] 


DELETE 


/BEFORE[:date] 
/DATE[:date] 
/ INFORMATION 
/SINCE[:date] 


DIBOL 
/LOG 


/PAGE:n 
/TABLES 
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/NOREWIND with restore operations begins the restoration at 
the current magtape position. The default operation is to 
rewind the magtape before restoration (/REWIND). 


/NOSCAN inhibits the bad-block scan on disk output volumes. 
Use /NOSCAN only on disk output volumes you know contain no 
bad blocks. The default operation is to scan each disk 
output volume for bad blocks (/SCAN). 


Valid only with /RESTORE/DEVICE/FILES options combination 
and only from magtape volumes. Use to indicate the saveset 
containing a file you want to restore. 


Valid only when used with /RESTORE option. Causes a 
comparison between named saveset and restored file or 
volume. 
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DIFFERENCES 


/DEVICE 


DIRECTORY 
/ BACKUP 
/OUTPUT[:filespec] Writes the results of a DIRECTORY/BACKUP operation to the 
specified file specification. The input device can be 
magtape or disk. The default operation (no option or option 
without file specification) displays the directory on your 
terminal. 


/PRINTER Directs the results of a DIRECTORY/BACKUP operation to your 
printer. 3 


/PROTECTION 
/NOPROTECTION 
EDIT 


/KEX 


EXECUTE 
/DUPLICATE 
/GLOBAL 
{L0G 
/PAGE:n 
/TABLES 

INITIALIZE 


/ BACKUP 


LINK 
/DUPLICATE 
/GLOBAL 
/LIMIT:n 

MOUNT 
/WRITE 
/NOWRITE 


PRINT 


/BEFORE[:date] 


/DATE[:date] 
/ INFORMATION 
/SINCE[:date] 


PROTECT 


/BEFORE [: date] 
/DATE[:date] 
/EXCLUDE 

/ INFORMATION 
/LOG 

/NOLOG 
/NEWFILES 
/QUERY 
/SINCE[:date] 
/SYSTEM 
/WAIT 


RECALL 


<number> 


<string> 


/ALL 


/CLEAR 


RENAME 
/BEFORE[:date] 
/DATE[:date] 

/ INFORMATION 
/SINCE[: date] 
SET 


dd CSR=n 
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is a decimal number. SL retrieves the command that was 
issued the specified number of times ago. (The /ALL option 
displays a decimal number next to each command in the stack, 
indicating that command’s relative position in the stack.) 


is a character string. SL retrieves the most recently 
stored command that begins with the entered string. You can 
use the shortest unambiguous string that corresponds to the 
stored command. 


causes SL to list all previously entered commands that are 
stored on the command stack. A decimal number is displayed 
next to each command, indicating that command’s position on 


the stack. The asterisk (*) displayed next to a command 
indicates it is the first command in the current cycle of 
commands. That command is the next retrieved when you type 


<PF1><Up-Arrow>. (Set cycle and cycle functionality is 
described in Appendix E.) 


causes SL to erase the stack of previous commands and reset 
the number of CYCLE lines to two. 
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RETRY=n 
SUCCES 
NOSUCCES 
VECTOR=n 
DU CSRO=n Modifies the DU handler to use n as the CSR address for 
controller 0. Equivalent to SET DU CSR=n. 
DU VECO=n Modifies the DU handler to use n as the vector address for 
controller 0. Equivalent to SET DU VECTOR=n. 
DU CSR1i=n Modifies the DU handler to use n as the CSR address for 
controller 1. 
DU VEC1=n Modifies the DU handler to use n as the vector address for 
controller 1. 
DU CSR2=n Modifies the DU handler to use n as the CSR address for 
controller 2. 
DU VEC2=n Modifies the DU handler to use n as the vector address for 
controller 2. 
DU CSR3=n Modifies the DU handler to use n as the CSR address for 
Controlier 3s. 
DU VEC3=n Modifies the DU handler to use n as the vector address for 
controller 3. 
DUn PART=x 
PORT=x 
UNIT=x 
DW WCHECK 
_ * NOWCHECK 
WRITE 
NOWRITE 
DXn WRITE 
NOWRITE 
DYn WRITE 
NOWRITE 
EDIT KEX 
EL LOG 
NOLOG 
PURGE 
EXIT SWAP 
NOSWAP 
KMON IND 
NOIND 


eoabe 
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LD EMPTY 
LDn CLEAN 
WRITE 
NOWRITE 
LP BIT8 
NOBIT8 
ENDPAG=0 
ENDPAG=n 
LS BIT8 
NOBIT8 
ENDPAG=0 
ENDPAG=n 

LS GRAPH Sets the LS handler to output all characters regardless of 
the width of the line. Use this command for plotters such 
as the LVP-16 or any other graphics devices that use the LS 
handler. When you SET LS GRAPH, any width limit you 
specified using the SET LS WIDTH command is ignored. 

LS NOGRAPH Sets the LS handler to ignore all characters that do not fit 
on a line. Excess characters are not printed. The length 
of the line is determined by SET LS WIDTH=nnnnn. SET LS 
NOGRAPH is the default setting. 

LS SPEED=n 

MS RETRY=n Lets you change the number of times the MS handler attempts 
to recover from an error when the Error Logger is running. 

MS CSR=n Modifies the MS handler to use n as the CSR address for 
CONETOLLEY i. 

MS VECTOR=n Modifies the MS handler to use n as the vector address for 
controller 1. 

MS CSR2=n Modifies the MS handler to use n as the CSR address for 
controller 2. 

MS VEC2=n Modifies the MS handler to use n as the vector address for 
controller 2. 

MS CSR3=n Modifies the MS handler to use n as the CSR address for 
controller 3, 

MS VEC3=n Modifies the MS handler to use n as the vector address for 
controller 3. 

MS CSR4=n Modifies the MS handler to use n as the CSR address for 
controller 4. 

MS VEC4=n Modifies the MS handler to use n as the vector address for 


controller 4. 
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MS CSR5=n Modifies the MS handler to use n as the CSR address for 
concroller 5. 


MS VEC5=n Modifies the MS handler to use n as the vector address for 
Controller 3. 


MS CSR6=n Modifies the MS handler to use n as the CSR address for 
controller 6. 


MS VEC6=n Modifies the MS handler to use n as the vector address for 
controller 6. 


MS CSR7=n Modifies the MS handler to use n as the CSR address for 
controller 7. 


MS VEC7=n Modifies the MS handler to use n as the vector address for 
controller 7. 


MS CSR8=n Modifies the MS handler to use n as the CSR address for 
controller 8. 


MS VEC8=n Modifies the MS handler to use n as the vector address for 
controller 8. 


MUn DEFALT Returns magtape unit n to default density of 6250 bits/in. 
Valid only with 9-track TMSCP magtapes and sets only the 
specified magtape unit. 


MUn DENSE=1600 Sets density for only 9-track TMSCP magtapes and 

MUn =6250 for only the specified magtape unit. Setting DENSE=1600 
specifies 1600 bits/in (phase encoded). Setting DENSE=6250 
specifies 6250 bits/in (group code recording). 


MUn PORT=x Defines which port to access when magtape unit n is 
specified. The variable x is an integer in the range 0-3 
and corresponds to the variable x used with the SET MU 
CSRx=n and SET MU VECx=n commands. By default, the port 
variable x is the same as the magtape unit n. Valid only if 
the handler is assembled for multiple ports (units). 


MU RETRY=n Modifies the MU handler to use n as the number of times MU 
attempts to recover from an error. The value n must be an 
integer in the range 1 through 127. The default value for n 
is 8. 


MU [NO]SUCCES Modifies the MU handler to [not] log successful I/O 
transfers as well as errors when the Error Logger is 
running. SUCCES is the default mode. 


MUn UNIT=x Defines which TMSCP unit number to access when magtape unit 
nh is specified. The variable x is an integer in the range 
0-255. The default value for x is 0. Since each TMSCP unit 
requires a controller, this modification is optional and is 
used only if you have multiple TMSCP devices and you have 
modified the unit number on the device front panel. 
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NQ 
NQ 


SL 


CSRO=n 


VECO=n 


CSRi=n 


VEC1=n 


CSR2=n 


VEC2=n 


CSR3=n 


VEC3=n 


SHOW 
CSR=n 


SHOW 


VECTOR=n 


CSR=n 


SHOW 


VECTOR=n 


ASK 
KMON 


INSERT 


LEARN 
NOLEARN 


Modifies the 
controller Q. 


Modifies the 
controller 0. 


Modifies the 
controller l. 


Modifies the 
controller 1. 


Modifies the 
controller 2. 


Modifies the 
controller 2. 


Modifies the 
controller 3. 


Modifies the 
coptroller 3. 


Modifies the 


Modifies the 
Modifies the 


Displays the 
controller. 


Modifies the NU handler 


Causes characters to be placed 
shifting to the 


Character. 


MU handler to use n 


Equivalent to SET 


MU handler to use n 


Equivalent to SET 


MU handler to use n 


MU 


MU 


NQ 


NQ 


handler 
handler 
handler 
handler 


handler 


handler 


handler 


handler 


station 
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as the CSR 
MU CSR=n. 


as the vector 
MU VECTOR=n. 
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LET 
NOLET 
OFF 
ON 


REPLACE Places characters in a command line at the current cursor 
position by replacing the character or space at that 
position. 


SYSGEN 
TILL 
NOTTYIN 
VEZ 
VT100 
VT102 
WIDTH=n 


SP ENDPAG=0 
ENDPAG=n 
FLAG=n 
FORMO 
NOFORMO 
KILL 
NEXT 
WAIT 
NOWAIT 
WIDE 
NOWIDE 


VM BASE=nnnnnn 

VM SIZE=nnnnnn Lets you select the memory size, in blocks (512 bytes for 
each block), of the virtual device. If you SET VM SIZE=0, 
VM allocates all available memory from the SET VM BASE value 
to the top of physical memory. VM SIZE=0 is the default. 


XC SPEED=n 


SETUP 
480 INTERLACE 


COLOR 
MONO 


COMPOSE 
NOCOMPOSE 


DATA 
TYPE 


LANDSCAPE 
PORTRAIT 


NORMAL Turns off terminal and printer character attributes, such as 
REVERSE, UNDERLINE, and BOLD. 
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REVERSE REVERSE places terminal characters in reverse video mode. 
NOREVERSE NOREVERSE places terminal characters in normal video mode. 
RETAIN 

SETCOLOR color [pcolor:value, pcolor: value, pcolor: value] 


SETCOLOR color FACTORY 


SHOW 
COMMANDS 
/OUTPUT: filespec 
/PRINTER 
MEMORY 


SUBSET 


TYPE 
/BEFORE[: date] 
/DATE[:date] 
/ INFORMATION 
/SINCE[:date] 
UNPROTECT 
/BEFORE [: date] 
em /DATE[: date] 
/EXCLUDE 
/ INFORMATION 
/LOG 
/NOLOG 
/NEWFILES 
/QUERY 
/SINCE[:date] 
— /SYSTEM 


/WAIT 
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2.4 DEVICE CODES 


The following device codes have been assigned. 


Name Code Device 

MU 60 TMSCP magtape class handler 
NC/NQ/NU 61 Ethernet class handler 

SD 62 DBG-11 handler 

ST 63 DBG-11 symbol table handler 


2.5 HANDLERS 


The following handlers, distributed on the RT-11 V5 distribution kit, are no 
longer supported by RT-11 and are therefore no longer documented in the RT-11 
documentation set. You can still use these handlers as documented in previous 
versions of RT-11. 


CR DT 
CT EL 
DP PD 
DS RF 


Also, support for VT11 and VS60 graphics terminals is no longer included by 
default in the system monitor. You must perform system generation procedures to 
include that support. . 


XM versions of all supported handlers are now included on the RT-11 distribution 
a A oe 


All RT-11 handlers are now linked using the /NOBITMAP option. 


The following sections describe the changes made to RT-11 handlers. 


2.02. DD 
The following changes or new information applies to the DD handler: 

@® Previously, valid values for the SET dd: RETRY=n command for device 
handlers were varied. For RT-11 V5.4A, valid RETRY values for all 
device handlers that support this command (including DD) are 1 through 
127(decimal). The default number of retries is 8. 


@ The DD handler now operates on the SBC-11/21 and SBC-11/21 PLUS. 
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The following SET commands are valid for the DD handler: 
SET DD RETRY=n 
SUCCES 
NOSUCCES 


See the RI-11 System User’s Guide for a description of those commands. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to DD. 


2.5.2 DL 


The following changes or new information applies to the DL handler: 


Previously, valid values for the SET dd: RETRY=n command for device 
handlers were varied. For RT-11 V5.4A, valid RETRY values for all 
device handlers that support this command (including DL) are 1 through 
127(decimal). The default number of retries is 8. 


The following SET commands are valid for the DL handler: 


SET DL CSR=n 
RETRY=n 
SUCCES 
NOSUCCES 
VECTOR=n 


See the RI-11 System User’s Guide for a description of those commands. 
The DL handler now maintains device size information in a unit-specific 
table. That feature reduces the number of controller operations 
required in a system with multiple DL units. 


The DL handler now reports write-lock and write-gate errors to the error 
logger. 


The DL handler supports 22-bit DMA with the RLV12 controller. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to DL. 


The following changes or new information applies to the DM handler: 


® Previously, valid values for the SET dd: RETRY=n command for device 


handlers were varied. For RT-11 V5.4A, valid RETRY values for all 
device handlers that support this command (including DM) are 1 through 
127 (decimal). The default number of retries is 8. 


® 

@ 
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@ 
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@® The following SET commands are valid for the DM handler: 


SET DM RETRY=n 
SUCCES 
NOSUCCES 


See the RT-11 System User’s Guide for a description of those commands. 
@® The DM handler now reports the following errors to the error logger: 
Cylinder overflow 
Data late 
Transfer to or from nonexistent drive 


Transfer to or from memory address higher than existing 
memory 


Write-lock 


Use the new on-line index, INDEX, to find the latest information about topics 
related to DM. 


2.5.4 DU 


The following changes or new information applies to the DU handler: 


2.5.4.1 Changes to the DU Translation Tables - Changes have been made in the 
structure of the DU handler translation table. The names of the offsets in the 
table and the size of the table have changed for RT-11 V5.4. All programs you 
write to access the information contained in the table should use the following 
offsets. All programs you have written should be changed to use the following 
offset names. 


The new DU unit translation table consists of a table header followed by table 
entries. Previously, the DU unit translation table had no header. Now, the DU 
unit translation table has a header starting at offset DU.ID, which is a word 
containing the Radix-50 value for the characters DU. 


~DU.ID is followed by DU.NUM. The low byte of DU.NUM contains the number of 
entries in the table. For RT-11 V5.4, DU.NUM contains the value 10(octal). The 
high-byte of DU.NUM is reserved. 


The structure of the rest of the table remains as before. However, the offset 


names you should use to specify elements of the table have changed. The 
following is the structure of the table with the changed offset names: 
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Table Header 


Offset Name Meaning 

0 DY...ID Radix-50 value for characters DU 

2 DU.NUM Byte containing number of entries in table 
3 Reserved 

4 DU. ENT The offset to the first table entry 


Each table entry consists of 4 bytes. DIGITAL recommends 
you use the symbol DU.ESZ to represent the 4-byte size of 
each entry. 


Table Entries 


0 DU.UNI Physical MSCP unit number 

2 DU.PAR Byte containing partition number 

3 DU.POR Byte containing MSCP port (controller) number 

Each table entry consists of 4 bytes. DIGITAL recommends you use the name 


DU.ESZ to represent the 4-byte size of each entry. 


2.5.4.2 Other Changes to the DU Handler 


® Previously, valid values for the SET dd: RETRY=n command for device 
handlers were varied. For RT-11 V5.4A, valid RETRY values for all 
device handlers that support this command (including DU) are 1 through 
127(decimal). The default number of retries is 8. 


@e For RT-11 V5.4A, DU displays the following error message if bad-block 
replacement on a device is performed by the DU handler and DU is unable 
to replace a block on that device: 


?DU-E-Replace command failure. 
?DU-E-Software write protecting volume. 


If you receive that message, you should immediately back up that volume. 
Then check any file you had open for lost data. You cannot write to 
that volume again without first taking it off line and then placing it 
on line. | 


@ Some DU system conditionals used by SYSGEN have been changed for RT-11 
V5.4. See Section 2.37.3. 


@ DU now has a status word containing information about the last operation 
performed by the handler. The status word is called STATUS, and for 
v5.4 is located at offset 16 from the base of DU. The offset of STATUS 
may change with future releases of RT-11. The low 5 bits of STATUS 
contain the status information. All other bits are reserved. 
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Octal Value Meaning When Set 
00 Success 
01 Invalid command 
02 Command aborted 
03 Unit off line 
04 Unit available 
05 Medium format error 
06 | Write-protected medium 
07 Compare error 
10 Data error 
cme Host buffer access error 
12 Controller error 
3 Drive error 


Use DBG-11, ODT/VDT, or the E keyboard command to examine the contents 
of STATUS. You will need to perform customization patch 2.7.32 located 
in the RT-11 Installation Guide to use the E command. Use the SHOW 
MEMORY command display to find the base of the DU handler and add the 
offset to that base. 


The low-memory size of the DU handler when run under the XM monitor has 
been reduced from approximately 550 words to approximately 170 words. 
Data and code that was previously resident in low memory has now been 
placed in a global region in extended memory. Using the same technique, 
bad-block replacement support adds only approximately 16 words to the 
low-memory portion of the DU handler. Approximately 1900 words required 
for bad-block replacement support are placed in extended memory. 


You can now specify an option during SYSGEN that lets you boot RT-11 
from any DU port. If you do not specify DU multiport booting during 
SYSGEN, you can boot RT-11 from DU port 0 only. Use the following 
procedure to enable multiport DU booting: 


1. Perform a SYSGEN and request support for multiple DU ports and 
multiple DU port booting. (See Section 2.37.1 for a reproduction of 
the SYSGEN dialog for DU multiport booting.) 


The distribution kit provides DU.SYS and DUX.SYS. After SYSGEN, you 
will have two additional files: DU.SYG and DUX.SYG. 


2. Rename DU.SYS to DU.DIS and rename DUX.SYS to DUX.DIS. This_ step 
saves the original distributed files. Rename DU.SYG to DU.SYS and 
rename DUX.SYG to DUX.SYS. 


3. Use the SET DUn commands to map the particular DU device to the MSCP 
unit, port, and partition numbers. For example: 


.SET DU3 UNIT=0, PORT=1 
.SET DU4 UNIT=1, PORT=1 
.SET DUS UNIT=2, PORT=1 


For the SET commands to take effect, you must UNLOAD and then LOAD 
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the handler if it is a data device or reboot it if it is a system 
device. 


See Section 10.11 of the RY-11 Software Support Manual _ for 
information on mapping an MSCP disk. 


4, Copy the resulting DU handler to the port on the DU devices you want 
to be able to boot. For example: 


,~COPY DUX.SYS DUS? 


5. To hard-boot the DU unit on a new port, use the COPY/BOOT command to 
copy the bootstrap to the desired DU port. The DU unit on that port 
will also support the soft-boot BOOT DUn: command. 


e DU has had support added for .SPFUN and ISPFN 376 and 377. #=For  ODU, 
.SPFUN/ISPFN 376 performs a write to the specified sector, and 
.SPFUN/ISPFN 377 performs a read from the specified sector. Those 
writes and reads are not absolute; bad-block replacement and block 
vectoring remain in force. 


.SPFUN/ISPFN 376 and 377 are especially useful because they can return 
Status information in the first word of the return buffer. Status 
information includes any occurrence of a bad-block error, forced error, 
or drive error. No notification of such errors is returned by a .WRITE 
or .READ request. 


The DU support for .SPFUN/ISPFN 376 and 377 is the same as for DM with 
the following exceptions: 


® DU supports an additional error code described in Sections 2.38 and 
Eo be 


e For DU, bad-block replacement and block vectoring remain in force. 


@ The DU handler supports bad-block replacement. DU bad-block replacement 
is supported only under the XM monitor. Do not change from the XM 
monitor to another monitor, for example FB, when using a DU device with 
bad-block replacement support. You lose bad-block replacement support 
when running the FB monitor, which can result in the loss of data. 


Bad-block replacement is a technique in which substitute blocks are 
provided for blocks that have caused a read or write error. The 
replacement blocks appear to occupy the disk positions of the original 
blocks, and the disk appears to contain only good blocks. All MSCP (DU) 
hard disk systems support bad-block replacement, performed either by the 
disk controller or as an optional feature of the DU handler selected 
during system generation. There is no bad-block replacement support for 
RX50 devices. 


In MSCP systems that use an RQDX1, RQDX2, or RQDX3 controller, bad-block 
replacement is performed by the controller. In those systems, bad-block 
replacement is done automatically by the hardware and is transparent to 
Bi=il. 
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In MSCP systems that use a KDA50, UDA5SO, KLESI-QA, or KLESI-UA 
controller, bad-block replacement can be performed by the DU handler. 
In those systems, bad-block replacement is an option that you select 
during system generation. If you specify bad-block replacement, the DU 
handler performs the replacements automatically. 


NOTE 


DIGITAL recommends that you perform a SYSGEN and request 
DU bad-block replacement support if you are using an 
RC25 or the RA80/RA81 series MSCP disks. Failing to 
provide DU bad-block replacement support for those 
devices can cause the loss of data or excessive bad 
blocks on those devices. 


The following table lists the MSCP controllers and drives supported by 
RT-11 and indicates whether bad-block replacement is performed by the 
controller or the DU handler. 


MSCP Bad-Block Replacement 


MSCP Bad-Block MSCP 

Controller Replaced by: Drive 

RQDX1 controller RD51-RD52 

RQDX2 controller RD51-RD52=-RD53 

RQDX3 controller RD31-RD32-RD51-RD52-RD53=-RD54 
KLESI-QOA handler RC25=-RCF25 

KLESI-UA handler RC25-RCF25 

UDA50 handler RA80-RA81 

KDA50 handler RA80-RA81 


Whether bad-block replacement is performed by the controller or the 
handler, it has the effect of making a disk appear to be error free. In 
certain cases, however, an 1/0 operation, a verification procedure, or a 
bad-block search may report the presence of bad blocks on a disk with 
replaced blocks. In such cases, any block identified as a bad block 
should be considered to be a good block with bad data. This means that 
the controller or handler provided a replacement block for a defective 
block but was unable to recover the data it contained. 


A significant loss of performance occurs when running DU under the SJ 
monitor. 


By-pass recovery for SPFUN 360 (and SPFUN 371) is now enabled when you 
specify 1 for the blk argument. Enabling by-pass recovery lets the DU 
handler determine if an error is recoverable and if so, retry the SPFUN 
360 operation. 


For compatibility with the MU handler, DU supports SPFUN 360. For DU, 
SPFUN 360 is functionally equivalent to and is the replacement 
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for SPFUN 371 (direct MSCP access). SPFUN 371 is supplied for 
nm, compatibility purposes only and support for it could be removed in a 
future release of RT-11. 


e If the went argument in SPFUN 360 (special function bypass) is zero, the 
physical address specified in the command message is used. If went is 
nonzero, it specifies the virtual address of the data buffer. That 
Virtual address is converted to a physical address and placed in the 
command message. 


® You can determine the status information for a DU (MSCP) device, using 
the IGTDUS system subroutine. MSCP device status information includes 
the unit name, the physical device size, the availability of the unit, 
whether it is removable, and whether it is write protected. See Chapter 
1 for details on IGTDUS. 


® You can now perform absolute (non-file-structured access) reads and 

writes to any MSCP device, using the JREAD and UJWRITE system 
™ subroutines. JREAD and JWRITE use a 28-bit starting block number, which 
lets you read and write to any block on any DU device. See Chapter 1 
for details on JREAD and JWRITE. 


@ The following SET commands are changed for the DU handler: 


SET DU CSRO=n 

VECO=n 

CSRi=n 

VEC1=n 

fn, CSR2=n 
VEC2=n 

CSR3=n 

VEC3=n 


See Section 2.3.3 for details. 
@ The following SET commands are valid for the DU handler: 

a SET DU RETRY=n 
ie SUCCES 

NOSUCCES 

SET DUn PART=x 

PORT=x 

UNIT=x 


See the RT-11 System User’s Guide for more information on those 
commands. 


Use the new on-line index, INDEX, to find the latest information about topics : 
related to DU. 


fm 
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Zenuo DE 
The following changes or new information applies to the DW handler: 


@® Previously, valid values for the SET dd: RETRY=n command for device 
handlers were varied. For RT-11 V5.4A, valid RETRY values for all 
device handlers that support this command (including DW) are 1 through 
127(decimal). The default number of retries is 8. 


e Before RT-11 V5.3, the DW handler applied the wrong mapping of logical 
block numbers to physical block numbers on RD5x hard disks. The mapping 
was corrected in RT-11 V5.3. If you are upgrading your system from 
RT-11 V5.3 to V5.4, you have already reconfigured your DW hard disk and 
you do not need to be concerned with this change. If you are upgrading 
your system from a version of RT-11 previous to V5.3, be sure to read 
the cover letter included with your RT-11 V5.4 distribution. 


The DW mapping error caused file-structured operations (.READ/.WRITE 
requests) to map to different locations than non-file-structured 
operations (.SPFUN requests). File-structured and non-file-structured 
operations were corrected for RT-11 V5.3; however, see the ISPFN and 
.SPFUN information in Sections 2.38 and 2.39 for changes to the blk 
argument. 


Because DW mapping was changed for RT-11 V5.3, all RD5x hard disks that 
were used by a version of RT-11 before V5.3 must be reconfigured, which 
is done automatically by the Automatic Installation Procedure. However, 
any RD5x hard disk not in your processor during Automatic Installation 
must be initialized using RT-11 V5.4 or a subsequent version before use. 
Copy any files you want to preserve to RX50 diskettes, using the version 
of RT-11 that wrote those files to the RD5x. Then, initialize the RD5x 
hard disk, using RT-11 V5.4 or a subsequent version. 


Reconfiguration of two RD52 hard disks changes their usable size in 
blocks. The following table shows the changes: 


Size Before Size After 
Manufacturer Reconfiguration Reconfiguration 
CDC Size is unchanged 
Atasi 55679. blocks 65535. blocks 
Quantum 65535. blocks 65407. blocks 


The reduction of 128(decimal) blocks in usable size of the Quantum RD52 
is caused by correction of an error in previous versions of RT-11. An 
area reserved by the disk was incorrectly allocated for data storage. 


® DW uses the .DRPTR macro to reduce its memory-resident size by moving 


device sizing and initialization code to non-memory-resident FETCH and 
LOAD code. That makes DW more than 150 words smaller (in memory). 
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@® The following FORMAT commands are now valid for the DW handler: 
FORMAT DW 
FORMAT/VERIFY DW 
FORMAT/VERIFY:only DW 

® The following INITIALIZE command is now valid for the DW handler: 
INITIALIZE/BAD DW 

@® The following SET commands are valid for the DW handler: 


SET DW RETRY=n 
SUCCES 
NOSUCCES 
| WCHECK 
i’ NOWCHECK 
WRITE 
NOWRITE 


See The RT-11 System User’s Guide for more information on those 
commands. 


Use the new on-line index, INDEX, to find the latest information about topics : 
related to DW. 


2.9.6 DX 
The following changes or new information applies to the DX handler: 


e Previously, valid values for the SET dd: RETRY=n command for device 
handlers were varied. For RT-11 vV5.4A, valid RETRY values for all 
device handlers that support this command (including DX) are 1 through 

yo 127 (decimal). The default number of retries is 8. 


@e The following SET commands are valid for the DX handler: 


SET DX CSR=n 
RETRY=n 
SUCCES 
NOSUCCES 
VECTOR=n 
WRITE 
NOWRITE 


See the RT-11 System User’s Guide for more information on those 
commands. 


Use the new on-line index, INDEX, to find the latest information about topics : 
related to DX. 
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funse DY 
The following changes or new information applies to the DY handler: 


@ Previously, valid values for the SET dd:  RETRY=n command for device 
handlers were varied. For RT-11 V5.4A, valid RETRY values for all 
device handlers that support this command (including DY) are 1 through 
127 (decimal). The default number of retries is 8. 


e The following SET commands are valid for the DY handler: 


SET DY CSR=n 
RETRY=n 
SUCCES 
NOSUCCES 
VECTOR=n 
WRITE 
NOWRITE 


See the RT-11 System User’s Guide for more information on those 
commands. 


® The DY handler supports only ECO Revision Level F and later controllers. 


; Use the new on-line index, INDEX, to find the latest information about topics 
related to DY. 


2.0468 DZ 
The following changes or new information applies to the DZ handler: 

@® Previously, valid values for the SET dd: RETRY=n command for device 
handlers were varied. For RT-11 V5.4A, valid RETRY values for all 
device handlers that support this command (including DZ) are 1 through 
127 (decimal). The default number of retries is 8. 

@ The following SET commands are valid for the DZ handler: 

SET DZ RETRY=n 
SUCCES 
NOSUCCES 


see the RT-11 System User’s Guide for more information on those 
commands. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to DZ. 
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2.9.9 ID 


The following changes or new information applies to the LD: See Appendix F for 
complete information on using LD. 


2.5.9.1 Changes to the LD Translation Tables - Changes have been made to the LD 
translation tables for RT-11 v5.4. All programs you write to access the 
information contained in those tables should use the following information. All 
programs you have written to access LD translation tables should be changed to 
use the following information. 


The following characteristics of the LD translation tables have changed from 
those documented in Section 10.13.1 of the RT-11 Software Support ManuaJ: 


@ Changes have been made to .SPFUN 372 for RT-11 V5.4. All programs you 
have written that use .SPFUN 372 for LD must be changed to reflect the 
‘following: 


The meaning of the went argument is changed for RT-11 V5.4. The 
meaning for the values in the .SPFUN 372 went argument for LD are 
now consistent with those for DU. The went argument now takes the 
following values: 


went = +1 read from handler to buffer 
-1 write from buffer to handler 


For RT-11 V5.4, the buf argument must be specified as 0. 


@ Previously, the LD translation tables started at label HANDLR. Now, the 
LD translation tables start at label LD.ID. Label LD.ID is a l-word 
table identification and contains the Radix-50 value for the characters 
dibs 


® LD.ID is followed by a 1l-byte count of the number of entries in the 
table. That byte, LD.NUM, is the low-byte of the word LD.ID+2, and for 
RT-11 V5.4 always contains the value 10(octal). The high-byte of 
LD.ID+2 is reserved. 


@ There are four LD translation tables. That is unchanged. However, the 
names of offsets you use to reference the tables have changed. Some 
table contents have also changed. 


The following lists the offset names, their location, and the contents of the 
four LD translation tables: 


LD.FLG (LD.ID+4) 


The table beginning at offset LD.FLG is the table previously at the label 
HANDLR. LD.FLG contains one word for each LD unit number; that is, the 
value stored in LD.NUM. For RT-11 V5.4, there are always eight words in 
the LD.FLG table. The bits in each word of LD.FLG have the following 
meaning: 
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Bits Name Meaning 
O=5 LD .NDX An index to the handler tables in RMON for the 
physical device corresponding to the LD ‘unit 

number. 
6 LD . UNX A flag that signals the index entry (bits 0-5) may 


be inaccurate and should be updated. LD sets 
LD.UNX for all units if, upon entry, the LDREL$ 
bit in RMON fixed offset CONFG2 is set. 


f; LD. UOF A flag that signals the entry in the LD.OFS table 
for that LD unit may be inaccurate. LD.UOF is set 
whenever a volume is squeezed. LD checks LD.UOF 
each time it uses an LD unit; if set, LD verifies 
that unit’s LD.OFS table entry before proceeding. 


poLs LD .UNT Contain the unit number of the physical disk 
assigned to the logical disk unit. 

14 LD .RDO Is the write-lock bit. If LD.RDO set, the LD unit 
is read only. 

Lo LD.ACT Is the allocation bit. If LD.ACT set, the LD unit 
is assigned. If LD.ACT clear, the LD unit is not 
assigned. 


LD.OFS (LD.FLG+<2*Contents of LD.NUM>) 


The second translation table starts at the offset LD.OFS and contains one 
word for each LD unit number. The count of LD unit numbers is stored in 
LD.NUM. For RT-11 V5.4, the table starting at offset LD.OFS contains eight 
words. Each word in LD.OFS contains the offset in blocks from the 
beginning of the assigned physical disk to the start of the area on that 
physical disk assigned to that LD unit number. 


LD.SIZ (LD.FLG+<4*Contents of LD.NUM>) 


The third translation table starts at offset LD.SIZ and contains one word 
for each LD unit number. The count of LD unit numbers is stored in LD.NUM. 
For RT-11 V5.4, the table starting at offset LD.SIZ contains eight words. 
Each word in LD.SIZ contains the size in blocks of the area on the physical 
disk assigned to that logical disk unit. 


LD.NAM (LD.FLG+<6*Contents of LD.NUM>) 


The fourth translation table starts at the label LD.NAM and contains four 
words for each LD unit number. The count of LD unit numbers is stored in 
LD.NUM. For RT-11 V5.4, the table starting at offset LD.NAM contains 
32 (decimal) words. 


The first word of each 4-word entry contains the Radix-50 2-character name 
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of the physical disk that is assigned to that logical disk unit. That 
Radix-50 word must be the physical (not logical) device name without any 
unit number. DL is a valid physical device name; DL1 and DK are not valid. 


The second, third, and fourth words of each entry contain the Radix-50 file 
name and file type assigned as the logical disk. 


2.5.9.2 Other Changes to the LD Handler 


@ The MOUNT command causes LD to initially load any unloaded device 
containing a file you associate with a logical disk. That association 
remains in effect until you change it. However, if the device becomes 
unloaded, you must load it again to access that logical disk. 


@ You may need to issue the command SET LD CLEAN more than once to verify 
and correct nested logical disk assignments. Use the SHOW SUBSET 
command to determine logical disk subsetting assignments and repeat the 
SET LD CLEAN command as necessary. 


e For RT-11 V5.4, attempting to nest a logical disk within the same 
logical disk (MOUNT LD3: LD3:foo.dsk) is invalid and returns the error 
message, ?LD-F-Invalid nesting. 


@e For RT-11 V5.4, nesting a logical disk within a higher-numbered logical 
disk (MOUNT LD2: LD3:foo.dsk) is not recommended and for RT-11 V5.4, 
returns the warning message, ?LD-W-Invalid nesting. 


@ Use the following customization patch if you want to change the suffix 
character for the LD handler to anything other than X or M. (You can 
use the X and M suffixes without performing a customization patch.) You 
must also use customization patch D.3 Changing the Handler File-Name 
Suffix, located in the RT-11 System Generation Guide. The following 
customization makes known to the monitor bootstrap the suffix character 
you specified in that customization; you must specify the same suffix 
character in both. 


In this customization, monitor.SYS is the name of the monitor file you 
want to modify, and ..BLDS is the value of that symbol from the monitor 
link map. xxxxxx represents a number that varies but is not important 
for you to know, and y represents the suffix character you want to add 
to the LD handler name. 


.RUN SIPP<RET> 
xmonitr.SYS<RET> 
Base? O<RET> 
Offset? ..BLDS<RET> 


Base Offset Old New? 
000000 . .BLDS XXXXXX ; Ay<RET> 
000000 . .BLDS+2 XXXKXX <CTRL/Y><RET> 
*<CTRL/C> 
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@® The following SET command is valid for the LD handler: 
SET LD EMPTY 
See the RT-11 System User’s Guide for more information on that command. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to LD. 


Zxacal LP 
The following changes or new information applies to the LP handler: 


® LP has been converted to a file-structured-device handler to support the 
SET LP ENDPAG=n command. Issuing a directory operation (for example, 
the PRINT command) to LP while the printer is off line can cause the 
handler (and possibly the system) to appear hung. Place the printer on 
line or type CTRL/C twice to free the handler. 


@ The following SET commands are now valid for the LP handler: 


SET LP BIT8 
NOBITS8 
ENDPAG=0 
ENDPAG=n 


See the ART-11 System User’s Guide for more information on those 
commands. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to LP. 


ecoed2 US 
The following changes or new information applies to the LS handler: 


@ For RT-11 V5.4, the LS handler is distributed with support for both PRO 
and PDP-11 processors. The SYSGEN conditionals that enable that support 
are LSSPC=1 for the PRO and LSSPDP=1 for the PDP-11 processors. You can 
build an LS handler for only the PRO by requesting PC300 printer port 
support and also including the conditional LSSPDP=0 after replying Y to 
the SYSGEN prompt - Do you want to define or redefine any system 
conditionals (N)?. 


You can build an LS handler for only PDP-11 processors by requesting no 
PC300 printer port support in the SYSGEN dialog. 


@® For RT-11 V5.3, the SET LS CSR=nnnnnn command required the default 
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system generation PC300 printer port support. That support was included 
fm”, in all distributed monitors. For RT-11 V5.4, the SET LS CSR=nnnnnn 
command works as documented with all LS handlers except those generated 
for only PC300 printer port support during system generation. The CSR 
and vector addresses for the Professional 300 series processors are 
fixed by the hardware and cannot be set. 


@ The LS handler is now factory set for both Professional series 
processors (CSR=173400 and VECTOR=220) and traditional PDP-11 processors 
(CSR=176500 and VECTOR=300) . 


The LS handler automatically sets the correct CSR and VECTOR when being 
run on a Professional processor; the CSR and VECTOR for Professional 
processors cannot be changed. When the LS handler is being run on a 
Professional processor, the fixed CSR and VECTOR are displayed by the 
SHOW DEV command. 


The CSR and VECTOR can be changed for traditional PDP-11 processors with 
™ the SET LS CSR=n and SET LS VECTOR=n commands. Use those commands to 
set the LS handler CSR and VECTOR if your serial line printer is 
installed at a nonstandard address. The CSR and VECTOR for traditional 
PDP-11 processors is displayed by the SHOW DEV command when the LS 
handler is being run on a traditional PDP-11. 


The SHOW DEV command also displays a "temporary" VECTOR (470, 474) for 
the LS handler on Professional and traditional PDP-11 processors. RT-11 
uses that VECTOR while determining the type of processor on which LS is 


running. 
rN : 


@ RT-11 includes support for the LVP-16 plotter printer with the SET LS 
[NO]GRAPH command. See Section 2.3.3 for details. 


e LS has been converted to a file-structured-device handler to support the 
SET LS ENDPAG=n command. Issuing a directory operation (for example, 
the PRINT command) to LS while the printer is off line or XOFFed can 
cause the handler (and possibly the system) to appear hung. Place the 
printer on line or clear the XOFF condition, or type CTRL/C twice to 
a>. free the handler. 


@ The default setting for the LS handler has been changed from NOCTRL to 
CIRL. 


@ The following SET commands are now valid for the LS handler: 


SET LS BITS 
NOBIT8 
ENDPAG=0 
ENDPAG=n 
SPEED=n 


See the RI-11 System User’s Guide for more information on those 
commands. 


Use the new on-line index, INDEX, to find the latest information about topics : 
LD related to LS. 
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2.5.12 Magtape Handlers (MM, MS, MT, MU) 


The following information applies to all magtape handlers. Information about 
specific magtape handlers is listed under the particular handler name. 


@® Using a COPY/VERIFY operation to back up selected files from disk to 


magtape performs a block-by-block verification on that magtape; the 
magtape cannot stream and must constantly reverse and forward itself. 
Consequently, that type of operation can take a long time. You can 
greatly speed up that operation by first copying such files to an 
initialized interim disk, using COPY/VERIFY, and then back up that 
interim disk to magtape, using the BACKUP/DEVICE/VERIFY command. 


Magtape devices require that you close channels rather than just 
deactivate them when you terminate your program. DIGITAL recommends you 
use the .CLOSE request before you terminate a program that performs 1/0 
operations to any RT-11 magtape device. 


Some RT-11 utilities use the .PURGE request to deactivate a channel at 
program termination; that is appropriate for 1/0 operations to a disk 
device. You should LOAD some magtape handlers before they are used with 
some utilities. If you LOAD your magtape handler and you use a utility 
that performs a .PURGE, that utility can return an error message at the 
next attempted magtape access, because the channel has not been closed. 
You can clear that error condition by UNLOADing and then again LOADing 
the magtape handler. 


If a program does not require you to LOAD the magtape handler, then let 
the program .FETCH the handler. A .FETCH always loads a new copy of the 
handler into memory and therefore corrects any channel problem caused by 
a .PURGE request at program termination. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to magtapes and magtape handlers. 


2.5.13 MM 


The following changes or new information applies to the MM handler: 


Previously, valid values for the SET dd: RETRY=n command for device 
handlers were varied. For RT-11 V5.4A, valid RETRY values for all 
device handlers that support this command (including MM) are 1 through 
127(decimal). The default number of retries is 8. 


For RT-11 V5.4C, after MM is loaded or fetched, it clears the RHI11 
controller when the first operation to that controller is performed. MM 
continues to also clear the controller in response to certain other 
operations, such as rewind completion and aborts. 


mF 
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® For RT-11 V5.4, you can FETCH the MM handler in the XM environment. 


@ The following SET commands are now valid for the MM handler: 


Use the new on-line index, INDEX, to find the latest 


SET MM CSR=n 
RETRY=n 
VECTOR=n 


For a description of those commands, see the SET dd CSR=n, SET dd 
RETRY=n, and SET dd VECTOR=n commands in the RI-1l System User’s Guide. 


information about topics 


related to MM. 


2.5.14 MS 


The following changes or new information applies to the MS handler: 


Previously, valid values for the SET dd: RETRY=n command for device 
handlers were varied. For RT-11 V5.4A, valid RETRY values for all 
device handlers that support this command (including MS) are 1 through 
127 (decimal). The default number of retries is 8. 


For RT-11 V5.4, you can FETCH the MS handler under the XM monitor. 


For RT-11 v5.4, the MS handler supports 100 in/sec streaming for only 
the TSO05 magtapes under the SJ, FB, and XM monitors. However, RT-11 
contains no programs (including BUP) that use 100 in/sec streaming for 
TSO5 magtapes under XM. 


The following SET commands are now valid for the MS handler: 


SET MS CSR=n 
RETRY=n 
VECTOR=n 
CSR2=n 
VEC2=n 
CSR3=n 
VEC3=n 
CSR4=n 
VEC4=n 
CSR5=n 
VEC5=n 
CSR6=n 
VEC6=n 
CSR7=n 
VEC7=n 
CSR8=n 
VEC8=n 


See Section 2.3.3 for more information on those commands. 
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Use the new on-line index, INDEX, to find the latest information about topics 
related to MS. 


2.5.15 Mf 
The following changes or new information applies to the MT handler: 


® Previously, valid values for the SET dd:  RETRY=n command for device 
handlers were varied. For RT-11 V5.4A, valid RETRY values for all 
device handlers that support this command (including MT) are 1 through 
127 (decimal). The default number of retries is 8. 


® For RT-11 V5.4, you can FETCH the MT handler in the XM environment. 
@® The following SET commands are now valid for the MT handler: 


SET MT CSR=n 
RETRY=n 
VECTOR=n 


For a description of those commands, see the SET dd CSR=n, SET dd 
RETRY=n, and SET dd VECTOR=n commands in the R7-1l1 System User’s Guide. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to MT. 


2.5.16 MU 
The following changes or new information applies to the MU handler: 


@® For RT-11 V5.4C, the distributed MU handler supports only one ‘MIMSCP 
controller. The default CSR and vector addresses for that controller 
remain 774500 and 260. Previously, the distributed MU handler supported 
two TMSCP controllers. 


You must now perform a SYSGEN to build support in MU for the second and 
Subsequent TMSCP controllers. The CSR and vector addresses for those 
controllers float; they depend on what other devices are on the bus. 
The default (indicated by SYSGEN) CSR addresses remain as before. 


For V5.4C, the default (indicated by SYSGEN) vector addresses for TMSCP 
controllers are: 


Controller Vector 
MUO 260 
MU1 340 
MU2 344 
MU3 350 
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@® Previously, valid values for the SET dd: RETRY=n command for device 
handlers were varied. For RT-11 V5.4A, valid RETRY values for all 
device handlers that support this command (including MU) are 1 through 
127 (decimal). The default number of retries is 8. However, this retry 
count is only used for certain initialization procedures. Retries for 
read/write operations are handled by the TMSCP controller and are not 
settable. 


® For RT-11 V5.4, you can FETCH the MU handler in the XM environment. 
® The following SET commands are valid for the MU handler: 


SET MUn DEFALT 
DENSE=1600 
DENSE=6250 
PORT=x 
RETRY=n 
SUCCES 
NOSUCCES 
UNIT=x 
CSRO=n 
VECO=n 
CSRi=n 
VEC1=n 
CSR2=n 
VEC2=n 
CSR3=n 
VEC3=n 


See Section 2.3.3 for more information on those commands. 


Use the new on-line index, INDEX, to find the latest information about topics | 
related to MU. 


2.5.17 NC, NQ, NU 
The following changes or new information applies to the NC, NQ, and NU handlers: 


® For RT-11 V5.4C, the bootstrap code no longer installs the NU _ handler. 
You must use the INSTALL NU command to install the NU handler. You can 
include that command in your start-up (STARTX.COM) command file. Issue 
the INSTALL NU command before you issue the LOAD NU command. 


When NU installs, it performs a self-test on the DEUNA or DELUA Ethernet 
controller. If that DEUNA or DELUA controller is not attached to either 
an Ethernet or a loopback connector, the NU handler hangs. You can 
recover from that hung condition by twice pressing <CTRL/C>. 


e The following SET commands are valid for the Ethernet handlers NC, NQ, 
and NU: 
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For NC: 
SET NC SHOW 
For NQ and NU: 
SET NQ CSR=n 
SHOW 
VECTOR=n 
SET NU CSR=n 
SHOW 
VECTOR=n 


See Section 2.3.3 for information on those commands. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to NC, NQ, or NU. 


Dine ET 
The following changes or new information applies to the PI handler: 


® The RT-11 V5.4 secondary DA (device attributes) reply for the 
Professional 300 series is now <ESC>[>7;0504c for the FB monitor and 
<ESC>[>8;0504c for the XM monitor. 


@ The Professional interface (PI) handler has been modified to support the 
.SPFUN programmed request and the ISPFN system subroutines for codes 370 
(read) and 371 (write). That PI support is required to support the 
PRO/GIDIS graphics utility. See the RT-11 Programmer’s Reference Manual 
for a description of the interface between PI and the PRO/GIDIS utility. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to PI. 


2.5.19 RK 
The following changes or new information applies to the RK handler: 
The following SET commands are now valid for the RK handler: 
SET RK CSR=n 
RETRY=n | 
SUCCES 
NOSUCCES 
VECTOR=n 
See the RT-11 System User’s Guide for more information on those commands. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to RK. 
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Zane. -SP 
The following changes or new information applies to the SP handler: 
The following SET commands are now valid for the SP handler: 


SET SP ENDPAG=0 
ENDPAG=n 


See the RIT-11 System User’s Guide for more information on those commands. Use 


the new on-line index, INDEX, to find the latest information about topics 
related to SP. 


bitael, Gee 


The following changes or new information applies to the multiterminal version of 
the TT handler: 


@ The default SET options for the multiterminal TT handler are now: 
SCOPE, CRLF, PAGE 


The default SET options for the multiterminal TT handler were previously 
NOSCOPE, CRLF, PAGE. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to TT. 


2.5.22 VM 
The following changes or new information applies to the VM handler: 


® You can specify the size for the VM device, using the SET VM SIZE=nnnnn 
command. See Section 2.3.3 for details. 


e An RT-11 XM monitor can now be booted from the extended memory VM 
device. 


When you create a bootable VM device, the VM handler you copy to that 
device must have its base set to the same value as the VM handler used 
to copy it to the VM device. That procedure is done automatically when 
you copy the VM handler residing on your system device to the VM device. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to VM. 


22g ee kG 


The following changes or new information applies to the XC handler: 
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@e For RT-11 V5.4B, the XC handler refuses to be unloaded until you pause 
or exit from VICOM. 

@® For RT-11 V5.4, additional functionality has been added to SPFUN 204 for 
XC and XL so that it now returns the following modem control information 
in bits 3 and 4 of the low byte of the user buffer: 

Bit Meaning 


3 Set indicates Carrier Detect is high (on); clear indicates 
Carrier Detect is low (off) 


& Set indicates Ring Indicator is high (on); clear indicates 
Ring Indicator is low (off) 


Because of changes made to SPFUN 204, the driver support level 
value returned in the high byte of the user buffer is now 
18 (decimal) rather than 17 (decimal). 


e The XC device handler for RT-11 V5.2 cannot be used with earlier 


versions of VTCOM. Earlier versions of the XC device handler 
cannot be used with V5.2 VICOM. Attempts to do so return an error 
message. 


e The following SET command is valid for the XC handler: 
SET XC SPEED=n 


See the RT-11 System User’s Guide for more information on that 
command. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to XC. 


2.5.24 Xh 
The following changes or new information applies to the XL handler: 


® For RT-11 V5.4B, the XL handler refuses to be unloaded until you pause 
or exit. from VICOM, 


@ Additional functionality has been added to SPFUN 204 for the XL handler. 
See the XC section above for information. 


e The XL device handler for RT-11 V5.2 cannot be used with earlier 
versions of VTCOM. Earlier versions of the XL device handler cannot be 
used with V5.2 VICOM. Attempts to do so return an error message. 

@e The following SET commands are valid for the XL handler: 


SET XL CSR=n 
VECTOR=n 


See the RT-1l System User’s Guide for more information on those 
commands. 


™ 


Use the new on-line index, INDEX, to find the latest 
related to XL. 
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information about topics : 


2.6 AUTOMATIC INSTALLATION 


The following changes, additions, or new information applies te the automatic 
installation procedure. 


For RT-11 V5.4C, the terminal identification portion of the automatic 
installation verification procedure (IVP) has been updated. The 
terminal identification program, IVP.MAC, now recognizes the existence 
of current terminals. IVP.MAC is assembled, linked, and run as part of 
the automatic installation verification procedure. 


For RT-11 v5.4, if automatic installation is not valid for your hardware 
configuration and your distribution is multivolume, you are prompted to 
mount diskette 1; diskette 1 boots the FB monitor on RX01/RX02 
distributions or the XM monitor on the RX50 distribution. If your 
hardware configuration is not valid and your distribution is a single 
volume (disk), the automatic installation procedure boots the FB monitor 
on that volume and refers you to the RT-11 Installation Guide. If your 
distribution is TK50, the automatic installation procedure boots the AI 
monitor on device VM; see Section 4.4 for information on manually 
installing RT-11 from a TK50 magtape. 


The automatic installation procedure is now uniform for all supported 


input and output media. You can use any valid input media to 
automatically install RT-11 on any valid output media residing on your 
system configuration. The automatic installation procedure displays a 


list of valid output devices that reside on your system and queries you 
as to which output (working system) device you want to use. 


The automatic installation procedure then formats (if necessary) and 
initializes the output media. It then copies the RT-11 operating system 
from the input to the output media. 


The following are supported input media: RX02 and RX50 diskettes, TK50 
magtape, and RLO1 and RLO2 disks. 


The following hard disks are the supported output media: RD31 and RD5x 
(DW), RLO1 and RLO2 (DL), RKO6 and RKO7 (DM), and all hard disks 
supported by the DU handler. Any supported hard disk you want to use as 
the output medium must contain at least 5600(decimal) blocks of 
contiguous free space. 


The automatic installation procedure now checks if a fixed output volume 
is on line, or if a removable output volume is mounted and on line. If 
it is not, you are referred to the user guide for that device for 
directions on mounting the volume and/or putting it on line. 
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The automatic installation procedure from TK50 magtape checks for 
sufficient extended memory before attempting the procedure. If there is 
insufficient extended memory, the automatic installation procedure 
returns an error message and begins manual installation. That error 
message is described in Appendix A. 


You can now perform the automatic installation procedure from the DL 
device without having a second DL device for media backup. However, if 
your configuration includes only one DL device, you cannot back up the 
DL distribution medium. 


The automatic installation procedure on Professional 300 series 
processors no longer queries as to whether you want to configure your 
working system. If you want to configure your working system, issue the 
following command after performing the automatic installation procedure 
and running the installation verification program (IVP): 


.IND CONFIG 


If your professional 300 series processor contains an RD52 hard disk 
manufactured by QUANTUM, you are notified that initializing that disk 
decreases its available size in blocks. You are referred to the R-II] 
on the PRO Cover Letter and queried as to whether you want to continue 
the procedure. 


The automatic installation start-up command file STARTA.COM now uses 
FORMAT/VERIFY to format hard disks on Professional 300 series processors 
before initialization. 


STARTA.COM has been changed to use the .STRUCTURE directive in IND to 
determine the file structure of a specified working disk. 


If the .STRUCTURE directive finds a recognized foreign or an unknown 
file structure, the procedure warns you and gives you the opportunity to 
continue or stop the procedure. 


If the .STRUCTURE directive finds an RT-11 file structure, the volume is 
examined for files. If files are found, the installation procedure 
warns you and gives you the opportunity to continue or stop the 
procedure. 


see the RT-11 System User’s Guide for a description of the .STRUCTURE 
IND directive. 


Automatic installation is provided for the TK50 cassette magtape. The 
RT-11 Automatic Installation Booklet, TK50 Magtape, describes this 
procedure. Section 1.5.1 of this manual contains a description of the 
procedure. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to automatic installation. 
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2.7 BATCH 
The following change or new information applies to the BATCH utility: 


@ Previously, BATCH could not run virtual jobs under the XM monitor. For 
RT-11 V5.4B, BATCH can now run virtual jobs under the XM monitor; the 
previous restriction concerning this no longer applies. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to BATCH. 


2.8 BINCOM 


The following changes or new information applies to the binary file comparison 
(BINCOM) program: 


® You can now use wildcards with BINCOM to compare multiple binary files. 
@ The /D option compares two entire volumes starting with block 0. 


See Chapter 2 of the RT-11 System Utilities Manual for more information on those 
changes to BINCOM. Use the new on-line index, INDEX, to find the latest 
information about topics related to BINCOM. 


2.9 BUP 
The following changes or new information applies to the backup (BUP) program: 


Significant enhancements have been made to the backup utility (BUP) program for 
V5.4B. See Appendix F of this manual for complete information. The following 
Changes have also been made to BUP: 


@ For RT-11 V5.4B, you can back up a smaller disk volume to a larger disk 
volume or to a disk volume of the same size. BUP no longer returns the 
error message, ?BUP-F-Enough space on one volume - use PIP. However, if 
you back up a smaller disk to a larger disk, the remainder of that 
larger disk is unusable. 


@® Previously, RT-11 did not print any warning message if you restored a 
device image to your system device. Doing that can cause an uncoupling 
of RMON and the system files and could corrupt your system device. For 
RT-11 V5.4B, BUP displays the following warning when you issue the 
command BACKUP/RESTORE/DEVICE (BUP /X/I) and your system device is the 
output volume: 


Restoring over SYSTEM volume! 
SY:/Restore; Are you sure? 
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@ RT-11 V5.4B supports the following new or changed options: 


/G inhibits the bad-block scan on disk output volumes. Use /G 
only on disk output volumes you know contain no bad blocks. 
The default operation is to scan each disk output volume for 
bad biocks. 


/M inhibits rewinding magtape before appending next saveset to 
that magtape. Increases the speed of backup operations but 
also stops saveset name verification (the magtape must rewind 
to check for unique saveset names). The default operation is 
to rewind the magtape before appending the next saveset to that 


magtape. 


/S Valid only with /X/I/F options combination and only from 
magtape volumes. Use to indicate the saveset containing a file 
you want to restore. For example, the following command line 
restores the file FILENAM.EXT, located on saveset MS0:FOO, to 
DLO: 


*DLO:=MS0:FOO/S, FILENAM. EXT/X/I/F 


/V:ONL Valid only when used with /X option. Causes a comparison 
between named saveset and restored file or volume. 


/W Suppresses various informational messages BUP prints as backup 
operations are performed. The default operation is to display 
the messages. 


ke inhibits various responses otherwise required from the 
terminal. Allows using BUP from KMON command and IND control 
files to write a single disk or magtape output volume (MOUNT 
prompts require terminal response). The default is to require 
terminal responses. 


/2 Must be specified to initialize a magtape; is automatically 
included with disk operations. 


By default, BUP successfully handles up to 25 bad blocks on the input 


device when backing up a disk to a tape or when restoring from a tape to. 


a disk (copy back). If any bad blocks are encountered on the output 
device, BUP issues a fatal error message and stops the backup operation. 


BUP issues a warning message each time it encounters a bad block on the 
input device, then continues to back up or restore. If BUP encounters 
more than 25 bad blocks on the input device, BUP issues a fatal error 
message and the operation is stopped. 


Use the following customization to set your own value for the number of 
bad blocks on the input device that BUP will accept. 
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Changing the Number of Bad Blocks That BUP Accepts 


In the customization, ..MBAD is the symbol for the value found at 
Section 2.7.64 in the file CUSTOM.TXT, and nnnnn is the new value that 
you enter. The maximum value you can enter is 77777(octal); that is, 
you can customize BUP to read 77777 bad blocks on the input device 
before the next bad block encountered causes a fatal error. The value 
you enter is also the number of verification mismatches that BUP reads 
on the input device before the subsequent mismatch causes a fatal error. 


. RUN SIPP<RET> 

* BUP . SAV<RET> 

Base? O<RET> 
Offset? . MBAD<RET> 


Base Offset Old New? 
000000 . .MBAD eal nnnnn<RET> 
000000 . .MBAD+2 XXXKK <CTRL/Y><RET> 
* <CTRL/C> 


® BUP can now verify data transferred to or from a device. Use the new /V 
option for this purpose. BUP prints an error message if the input data 


does not match the output data. 


@ BUP can now restore (copy back) a single file from a backup volume. Use 
the new /F option for this operation. To restore a file from a backed 


up volume, the volume must have been backed up using the BUP /I 
The /F option must be used with the /X and /I options (/X/I/F). 


option. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to BUP. 
2.10 CONFIG 
The following changes or new information applies to the unsupported CONFIG 
VELITey 
@ The following two options are added: 
Option Function 
/D[:yes] [:no] The /D option with no optional parameter causes 


CONFIG to return an error message in addition 


to setting bits in USERRB. You can 


success if no error message is returned. 


/D:yes causes CONFIG to continue to 
error messages without repeating the /D 
/D:no turns off /D:yes. 


/F:addr Determines whether file location addr 


assume 
Using 
return 
option. 


exists. 


If a read of location addr succeeds, USERRB is 


Agia a 
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set to 1. If a read causes a trap, USERRB is 
set to 10 (for fatal error). 


The /F option lets you use CONFIG comparison 
options (/V, /M, and /B) with files. Also, 
using /F with a file locks the specified file 
to CONFIG, which lets you access the file using 
only the /F option (without specifying the file 
again), and increases the access speed. 


CONFIG supports a /T option. Use the /T option to determine if an MSCP 
device unit contains fixed or removable media and whether that media is 
available. Use the following command syntax: 


.RUN CONFIG dev:/T:type 
where: 
dev is the MSCP device unit 
type is REM or FIX. Specify REM for type if you want CONFIG to 
logically assume the MSCP device media is removable. 
Specify FIX for type if you want CONFIG to assume the MSCP 


device media is fixed 


The following example tests MSCP device DU3 and assumes the media in DU3 
is removable: 


.RUN CONFIG DU3:/T:REM 


If the media in DU3 is removable, the user error byte (USERRB, byte 53 
in the system communications area) is set to 1 for success. If the 
media is not removable, USERRB is set to 4 for error. Iz DUS 28 not 
available, USERRB is set to 10 for fatal error. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to CONFIG. 


2.11 DIR 


The following changes or new information applies to the directory (DIR) utility: 


Previously, when you performed a directory (DIR command) on a magtape, 
you received the directory listing, the magtape rewound, and you then 
received the trailer information (number of files). For RT-11 V5.4, you 
receive the directory listing with the trailer information while the 
tape is rewinding. You receive the monitor prompt after the magtape has 
rewound. 


For RT-11 V5.4B, the above also applies when the directory information 
is directed to your printer (DIRECTORY/PRINTER command) . 
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@® RT-11 V5 includes the following additional directory program (DIR) 
options: 


/T includes in the directory listing only those files that are 
protected against deletion. 


/U. includes in the directory listing only those files that are not 
protected against deletion. 


See Chapter 4 of the R7T-11 System Utilities Manual for more information 
on those DIR options. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to DIR. 


2.12 DUP 


The following changes or new information applies to the device utility program 
(DUP): 


® Warning and error messages for DUP/I/Y (COPY/DEVICE/NOQUERY) and 
DUP/I/F/Y (COPY/DEVICE/FILES/NOQUERY) operations have been changed for 
RT-11 V5.4. See Appendix A for information. 


@ Informational system prompts displayed during DUP/I (COPY/DEVICE) and 
DUP/I/F (COPY/DEVICE/FILES) operations have been changed for RT-11 V5.4. 
A system prompt now notifies you if a COPY/DEVICE or COPY/DEVICE/FILES 
operation will produce a truncated output file or device. A truncated 
output file or device does not contain the whole input file or device 
(blocks are not copied and data can be lost). 


A system prompt now also notifies you when a COPY/DEVICE or 
COPY/DEVICE/FILES operation is from a smaller device or file to a larger 
device, because the /DEVICE option copies home and directory block 
information and therefore can reduce the available size of the output 
device. | 


A COPY/DEVICE operation where the output device is smaller than the 
input device returns the following system prompt: 


Output device is smaller than input device 
Output device will be truncated; Are you sure? 


A COPY/DEVICE operation where the output device is larger than the input 
device returns the following system prompt: 


Output device is larger than input device; Are you sure? 


A COPY/DEVICE/FILES operation where the output file is smaller than the 
input device returns the following system prompt: 


Output file is smaller than input device 
Output file will be truncated; Are you sure? 
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A COPY/DEVICE/FILES operation where the output device is smaller than 
the input file returns the following system prompt: 


Output device is smaller than input file 
Output device will be truncated; Are you sure? 


A COPY/DEVICE/FILES operation where the output device is larger than the 
input file returns the following system prompt: 


Output device is larger than input file; Are you sure? 


e The /H option when combined with the /K or /B option is now valid (with 
certain restrictions) to clear bad blocks caused by soft errors on MSCP 
class devices. 


The /H option causes RT-11 to read each block and, if it encounters an 
error, write the block out and then read it again. That forces the 
controller to clear (make usable) blocks that return a soft error. Use 
/H/K only with blank media or with media you have just backed up. This 
functionality is available only as a CSI-level command and is not 
implemented as a KMON command option. 


; The distributed RT-11 supports the /H option for RD31, RD32, RD51, RD52, 
RD53, and RD54 MSCP devices. You must perform a SYSGEN and request DU 
handler bad-block replacement support to use the /H option with RC25 or 

RA80 devices. 


The /H option when combined with the /K or /B option is recommended only 
for MSCP class devices. 


@ When you use the /I option to copy a larger volume to a smaller one, DUP 
asks for confirmation before copying the volume. 


@® You can now abort a /W (WAIT) operation. 


@® You can now combine the /R and /I options to preserve the output 
volume’s bad-block replacement table. In RT-11 V4, the input volume’s 
bad-block replacement table was always transferred to the output volume. 


® iIt is no longer necessary to customize DUP to use variable-size volumes. 
Instead, a handler attribute VARSZS5S can. be set to indicate a 
variable-size volume. Use the stat argument for the .DRDEF programmed 
request to set VARSZS (bit mask 400). Then, you can use the .DSTATUS 
programmed request to determine whether the handler Supports 
variable-size volumes (and .SPFUN 373). | 


see the RT-11 Programmer’s Reference Manual for more information. 
See Chapter 6 of the RT-11 System Utilities Manual for more information on those 


changes to DUP. Use the new on-line index, INDEX, to find the latest 
information about topics related to DUP. 
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2.13 EDIT 
The following changes or new information applies to the EDIT editor program: 


@ EDIT is no longer the distributed default editor. To make EDIT your 
default editor, include the command SET EDIT EDIT in your start-up 
command file. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to EDIT. 


2.14 ERROR LOGGER 
The following changes or new information applies to the error logger subsystem: 


e If you attempt to examine the contents of the error log before running 
ELINIT, ERRLOG returns the error message, ?ERRLOG-F-Invalid message 
received. You must run ELINIT before examining the error log. 


@ For RT-11 V5.4, the block number returned in the device error report is 
in decimal radix. Previously, the block number was in octal radix. 


@ The SJ monitor now supports the error logger. See Chapter 16 of the 
RT-11 System Utilities Manual for information on how to use the error 
logger under the SJ monitor. 


e The RT-11 V5 error logger reports the number of retries for a _ single 
error and the final status of the operation (success or failure). The 
error logger provides separate entries for retries only if the registers 
differ. 


@ You can choose to log successful I/0 transfers and errors or only 
errors. Use the SET dd SUCCES command to log successes as well as 
errors and the SET dd NOSUCCES command to log only errors. 


@ The error logger supports the DW (RD50/RD31/RD32/RD51/RD52 disk) and D2 
(RX50 diskette) handlers for the Professional series processors. 


@e The error logger supports the RC25 and RA80 disks. 
See Chapter 16 of the RT-11 System Utilities Manual for more information on 


changes to the error logger. Use the new on-line index, INDEX, to find the 
latest information about topics related to the error logger. 
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2.15 FILEX 


The following changes or new information applies to the file exchange (FILEX) 
program: 


@ The default device for all FILEX operations is DK:. 
@ There are two additional FILEX options: 


/V[:ONL] Use with /Z and /U[:n] simultaneously to write a volume 
identification during initialization of an interchange 
diskette. Use the [:ONL] argument to change § an 
interchange diskette’s volume ID without initializing 
the diskette. Use with /L or /F to list the volume ID 
of an interchange diskette when obtaining a directory 
listing. 


/W Initiates the operation but pauses and waits for you to 
mount different volumes. 


See Chapter 7 of the RT-11 System Utilities Manual for more information on those 
changes. Use the new on-line index, INDEX, to find the latest information about 
topics related to FILEX. 


2.16 FORMAT 


The following changes or new information applies to the volume formatting 
(FORMAT) program: 


® For RT-1ll V5.4A, the FORMAT utility supports formatting the RX33 
diskette. See Section 1.2.4 for information. 


® The error message, ?FORMAT-U-Channel in use, indicates an internal 
FORMAT error. If you receive that message, reboot your system and try 
the operation again. If the error occurs again, get a new copy of 
FORMAT.SAV and retry the operation. If the error persists, submit an 
SPR to DIGITAL. See Appendix B for information. 


@ Attempting to format a disk that is not mounted returns the error 
message, ?FORMAT-F-Device not ready. If you receive that message and 
your disk is not mounted, mount your disk and be sure it is up to speed. 


@ Formatting RD50, RD31, RD51, and RD52 hard disks is supported for 
Professional 300 series processors, using the commands FORMAT, 
FORMAT/VERIFY, and FORMAT/VERIFY:ONLY. See Section 4.1 for a 
description of formatting an unformatted hard disk on Professional 300 
series processors. 


@ The /VERIFY:only option can be used to perform the write/read verify 
Operation on the following devices: DD, DL, DM, DP, DT, DW, DX, DY, D2, 
and RK. 
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® If you try to format a volume that contains protected files or try to 
format a volume while a foreground job is loaded, FORMAT warns you and 
asks you to confirm the operation. 


® You can now abort a /W (WAIT) operation. 


e The table of verification bit patterns has been increased to 16 
patterns. The last 4 of the 16 patterns are reserved for future use. 


@® Formatting of devices at nonstandard addresses is now supported and will 
occur automatically, based on the CSR location specified in the device 
handler. 


See Chapter 8 of the RT-11 System Utilities Manual for more information on those 


changes to FORMAT. Use the new on-line index, INDEX, to find the latest 
information about topics related to FORMAT. 


2.17 HELP 
The following changes or new information applies to the HELP utility: 
® The files HELP.TXT and HELP.EXE, which together make up the program 
HELP.SAV, are no longer provided on the distribution kit. See Section 
2.7.14 in the RT-11 Installation Guide for information. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to HELP. 


2.18 IND 


The following changes or new information applies to the indirect control file 
(IND) processor: 


® Previously, the .READ directive incorrectly enforced the obsolete 
80-characters-per-line restriction; that restriction was removed for 
RT-11 V5.4. For RT-11 V5.4B, the .READ directive correctly allows 132 
characters per line. 


® For RT-11 V5.4B, you can change the default file type extension of IND 
control files, using the following customization patch. 


Changing the Default File Type Extension of IND Control Files 
As distributed, the file type extension for IND control files is  .COM. 


You can change that extension to distinguish IND control files from KMON 
command files (which also use the extension .COM). 


ros 
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In the customization, ..INDF is the symbol for a value located at 
section 2.7.66 in the file CUSTOM.TXT, and nnn is the new default RAD50 
3-character file type extension. 


. RUN SIPP <RET> 

* IND.SAV <RET> 
Segment? 0 <RET> 
Base? QO <RET> 
Offset? ,2iNDE “<RETS 


Old 


299909 


Offset 
.. LNDF 
.. NDF 


New? 
*R <RET> 
;Rnnn <CTRL/Y> <RET> 


segment Base 
000000 000000 
000000 000000 
* <CTRL/C> 


@ For RT-11 V5.4B, you can eliminate or change the terminating message of 


IND control files, using the following customization patch. 


Eliminating or Changing the IND Control File Terminating Message 


The terminating message in the distributed IND is 
whenever 
eliminate that message by specifying only a null 


message 


appears 


IND 


'@ <EOF>’ , That 
exits and returns control. You can 
Character or change 


that message by specifying up to 7 characters plus the null character. 


In the customization, ..INEO is the symbol for a value located at 
Section 2.7.67 in the file CUSTOM.TXT, and each n is an ASCII character 
in the new message. The required null character is an octal 0. 


.RUN SIPP <RET> 
x IND.SAV <RET> 


Segment? 0 <RET> 

Base? Q <RET> 

Offset? ..INEO <RET> 

segment Base Offset Old New? 
000000 000000 ..INEO fiver. Ge SET 
000000 000000 ..INEO <@> ;An <RET> 
000000 000000 ..INEOt+1 <-> FAR GREETS 
000000 000000 ..INEO+2 <<> ;An <RET> 
000000 000000 ..INEO+3 <E> ;An <RET> 
000000 000000 ..INEO+4 <O> ;7An <RET> 
000000 000000 ..INEO+5 <F> j7AN <RETO 
000000 000000 ..INEO+6 <>> ;An <RET> 
000000 000000 ..INEO+7 rec) 670. SRETS 
Segment Base Offset Old New? 
000000 000000 ..INEO+6 77777? \ <RET> 
segment Base Offset Old New? 
000000 000000 ..INEO+6 ?7?¢ ©<RET> 
000000 000000 ..INEO+7 vee ~O <CTRiGY> <RETO 


FCT RLS CS 


ee 
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@ The .TESTDEVICE and .VOL directives now support the <FILERR> special 
symbol. That support lets you intercept some read-related errors and 
perform error recovery. 


@® IND now dynamically determines whether RT-11 is running the XM monitor. 
If IND is running under the XM monitor, a portion of IND permanently 
resides in extended memory. That portion is displayed by the SHOW 
MEMORY command. Use the REMOVE IND command to eliminate that portion of 
IND in extended memory. 


@ IND dynamically allocates a region in extended memory for its symbol 
table when running RT-11 under the XM monitor. You can suppress the 
dynamic allocation, using a customization patch located in the RT7-11 
Installation Guide. 


® The .STRUCTURE directive has been added to IND to determine the file 
structure of a specified file-structured device from boot block 
information. 


@e The .TESTDEVICE directive has been modified to include ATT or NAT 
(attached or not attached) in field nine of special symbol <EXSTRI>. 


@ The .ONERR directive has been modified to include processing integer 
under/over flow conditions. 


e The .SETL directive has been modified to support the .AND, .OR, and .NOT 
logical test directives. When you use the .SETL directive, the logical 
symbol you specify is set to the value represented by the logical 
expression. 

@® The following operating modes have been added to the .ENABLE and 
.DISABLE directives. (These operating modes also apply to the 
.IFENABLED and .IFDISABLED directives.) 

. ENABLE/.DISABLE ABORT 
. ENABLE/ .DISABLE CONTROL-Z 
.ENABLE/ .DISABLE TYPEAHEAD 

e If the .ENABLE TIMEOUT directive is issued but the system does not 
include timer support, IND assigns special symbol <EXSTAT> the value 0, 
for warning, instead of printing an error message. 

See Chapter 5 of the RT-11 System User’s Guide for complete information on using 


IND. Use the new on-line index, INDEX, to find the latest information about 
topics related to IND. 


2.19 KED/KEX 


The following changes or new information applies to the keypad editor: 
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If you are simultaneously using two KED/KEX editors and you enter (and 
keep open) command mode on the first editor and then exit or quit the 
second, you cannot at that point reenter the first editor because it is 
still in command mode and will not accept input from the keyboard. If 
you attempt to reenter the first editor, you cannot return to the 
background or the foreground. 


To free the editor and the keyboard, you must return to the editor by 
using the appropriate special function key (CTRL/B, CTRL/F, or CTRL/X 
and the editor name) and press the ESCAPE key twice. You can then press 
CTRL/W to repaint the screen, enter command mode to exit or quit editing 
that file, or use a special function key to perform other functions. 


KED (or KEX) now sets bits in the USERRB byte (byte 53) to indicate 
whether you use the EXIT or QUIT command to leave the editor. If you 
exit KED, it sets bit 0 in USERRB for success. If you quit KED, it sets 
bit 1 ain USERRB for warning. Therefore, if you have set the error 
severity level to warning (SET ERROR WARNING) and are running KED from 
within an indirect file, quitting KED will cause an exit from the 
indirect file. 


KED is the default editor for the SJ and FB monitors, and KEX is the 
default editor for the XM monitor. 


<CTRL/R> or <CTRL/W> redisplays the screen. 
<PF1><CTRL/U> performs the same function as <PF1><PF4>. 
<PF1><DEL> performs the same function as <PF1><,>. 
<PF1><LINEFEED> performs the same function as <PF1><->. 


On terminals with AVO (advanced video option) or its equivalent, select 
ranges are displayed with reverse background and boldface. 


If the command EDIT/KED filespec is issued and the file you specify is 
not found, KED prompts you for permission to create the file. If the 
file is protected, KED prompts you for permission to inspect the file. 


A virtual version of KED, called KEX, runs only under XM. KEX can run 
as a background job, a foreground job, a system job, or as all three 
Simultaneously. 


The version of KED you are using appears as the prefix for messages 
displayed (?KED-, ?K52-, or ?KEX-). Formerly, all error messages were 
prefixed by ?KED-. 


KED now supports default file types. When editing a file, the default 
input file type is .MAC; the default output file type is the same as the 
input file type. When inspecting a file, the default input file type is 
-LST. There is no default input file type when creating a file. 
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To specify a file with no file type, type only the file name and the 
period separating the file name and type (FILNAM.). 


You can modify the default file types with the software customization 
described in the RT-11 Installation Guide. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to KED. 


2.20 LIBR 


The following changes or new information applies to the RT-11 librarian (LIBR) 
program: 


@ With RT-11 V5, LIBR continues instead of exiting when an error occurs. 
® The default file type for MACRO-11 libraries has been changed to .MLB. 


See Chapter 10 of the RT-11 System Utilities Manual for more information on 
LIBR. Use the new on-line index, INDEX, to find the latest information about 
topics related to LIBR. 


2.21 LINK 


The following changes or new information applies to the RT-11 linker (LINK) 
program: 


@e LINK cannot locate ina library module (and therefore resolve) any 
absolute global symbol, unless the symbol was included in the module 
using the LIBR /A option or the symbol was associated with at least one 
relative global symbol. The LIBR /A option is generally not used 
because it forces all global and absolute global symbols into the 
library module directory, making the directory quite large. It is 
generally better to associate any absolute global symbol with at least 
one relative global symbol. 


For example, assume that a library module contains the symbol SARGER 
that has an absolute value of 23 (SARGER==23). LIBR cannot locate and 
therefore LINK cannot resolve the symbol SARGER. You should associate 
that absolute symbol with a relative symbol; for example, GEO 
(GEO: :SARGER==23). Then, if you specified the library containing GEO in 
your command line, LINK could process the following code: 


.GLOBL GEO,SARGER 
TRAP SARGER 


e A problem with LINK’s CSI processing has been corrected, so that with 
RT-11 V5 you can link an increased number of modules at one time. 
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The /K:n option is no longer restricted to use for RSTS compatibility. 
You can now use the /K:n option with RT-11 to limit the number of words 
allocated by a .SETTOP programmed request. 


RT-11 V5 includes two additional LINK options: 
/D Defines the global symbol you specify once in each segment 
that references that symbol. Such global symbols must be 
defined in a library module. 


/N Produces in the load map a cross-reference listing of all 
global symbols defined during the linking process. 


See Chapter 11 of the RT-11 System Utilities Manual for more information on 


: those 


changes to LINK. Use the new on-line index, INDEX, to find the latest 


information about topics related to LINK. 


2.22 MACRO-11 


The following changes or new information applies to MACRO-11: 


RT-11 now supports MACRO-11 V5.4. 


Previously, MACRO-11 parsed arguments on .IF statements that were within 
unsatisfied conditional code blocks. MACRO-11 could return assembly 
errors (error code A) on lines of code that should not have been parsed. 
For MACRO-11 Version 5.4, MACRO-11 correctly keeps only a conditional 
nesting count and does not parse arguments of conditional statements 
within unsatisfied blocks of code. 


Previously, invalid nonprintable characters in MACRO-11 source code were 
not detected and flagged as errors. For MACRO-11 Version 5.4, invalid 
nonprintable characters are detected and flagged with an ’I’ error. 


Previously, the utility CREF.SAV did not produce a é correct 
cross-reference of a MACRO-11 program that contained more than 999 lines 
of code. For MACRO-11 Version 5.4, CREF.SAV produces correct 
cross-references under those circumstances. 


RT-11 supports the MACRO-11 8-bit functionality for the multinational 
character set. MACRO-11 supports the 8-bit multinational character set 
for some directives. See Appendix J of the PDP-11 MACRO-11 Language 
Reference Manual, Update 1, for information on 8-bit support. 


The default size of the MACRO-11 work file can be increased from 
128(decimal) blocks to a maximum of 256(decimal) blocks using a 
customization patch in the R7T-11 Installation Guide. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to MACRO. 
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2.23 MDUP 


The following changes or new information applies to the magtape device utility 
(MDUP) program: 


@® For RT-11 V5.4, the MDUP programs no longer support the following 
devices: RKO5, RPO2/RP03, RS03/RS04, and RF11. However, the MDUP 
programs now support VM and devices controlled by the DU handler. iia 
you need to create MDUP support for a device not supported in the 
distributed MDUPs, see Appendix A of the RT-11 Installation Guide. 


The text in Appendix A indicates the customization is for user-written 
devices. However, the customization also applies to device handlers 
distributed with RT-11 but not supported by the distributed MDUPs. The 
customization patch shows a value of 60000 for offset 1122, which 
produces the documented 12K words of memory when you boot the modified 
SJ monitor. DIGITAL recommends you use a value of 70000 at offset 1122, 
which produces 14K words of memory and lets you support more and/or 
larger devices. That value is the maximum size you can use; do not 
exceed the value 70000. 


@® You cannot use the distributed MDUP programs with LSI-11 or LSI-11/2 
processors. Perform the following procedure to build an MDUP program 
that you can use with your LSI-11 or LSI-11/2 processor: 


1. Use the SYSGEN procedure to build an SJ monitor on your LSI-11 
processor. You can use the distributed answer file SJFB.ANS to 
build a copy of the distributed SJ monitor. Respond Y to the second 
SYSGEN dialog question and specify SJFB.ANS in response to the third 
question. Respond appropriately to the rest of the SYSGEN prompts. 
You only need to build the SJ monitor; you do not need to build 
device handlers for this procedure. 


2. Modify that SJ monitor you built, using the procedure described in 
Appendix A of the RY-1l1 Installation Guide. Also see the 
information included in this section, located above. 


Follow the rest of the procedure described in Appendix A for 
customizing all handlers you want to support and then build an 
MDUP.?? as described. 


3. Use the monitor you built and modified, and the MDUP.?? file you 
created, with your LSI-11 processor. Use that SJ monitor only to 
build your MDUP.?? file, using that MDUP.SAV program; that monitor 
1s useless for any other application. 


® The magtape utility (MDUP) includes a /V:n option. The /Vin option 
checks that extended memory contains at least the number (n) blocks you 
specify. If extended memory contains n blocks, MDUP executes commands 
until another /V is encountered, whereupon MDUP stops executing the 
commands. 
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If extended memory contains less than n blocks, MDUP does not execute 
commands until another /V is encountered, whereupon MDUP starts 
executing the commands. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to MDUP. 


2.24 ODT 


The following changes or new information applies to the Octal Debugging 
Technique program: 


The following procedure lets you create a monitor-independent ODT 
debugger; that 1s, an ODT that does not require that the operating 
system be loaded in memory. 


The distributed debugger ODT.OBJ needs the operating system loaded in 
memory. You can modify ODT so it does not need the operating system 
loaded in memory. That could be useful, for example, in debugging the 
bootstrap. 


Use the following procedure to créate a debugger called ODTHWD.OBJ that 
functions independently of the operating system: 


1. Use KED to create the following patch program. Name it ODTPAT.MAC. 
In the program, substitute for the symbol ..GVAL the value for that 
symbol located at Section 2.7.65 in the file CUSTOM. TXT. 


(ELIE, ODT 
.PSECI SODTS 
BASEK=. .GVAL 


z. Assemble the created patch program: 


_R MACROK<RET> 
* ODTPAT=ODTPAT<RET> 
*<CTRL/C> 


3. Create the monitor-independent debugger ODTHWD.OBJ by modifying 
ODT.OBJ, which does not destroy the distributed ODT.OBJ, but 
modifies a copy of it. Use the utility PAT.SAV in the following 
manner: 


.R PAT<RET> 


* ODTHWD=ODT, ODTPAT<RET> 
kKCTRL/ C> 


4, Explicitly specify ODTHWD in the LINK/DEBUG command. If you do not 
specify ODTHWD, RT-11 by default links the distributed ODT. 


, LINK/DEBUG:ODTHWD program<RET> 
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Use the new on-line index, INDEX, to find the latest information about topics 
related to ODT. 


2.25 PAT 


The following changes or new information applies to the Object Module Patch 
(PAT) program: 


® When PAT finishes executing a command, control returns to the CSI 
(indicated by the asterisk prompt, *) rather than to the keyboard 
monitor. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to PAT. 


2.20. PIP 


The following changes or new information applies to the peripheral interchange 
(PIP) program: 


@ PIP now performs a .RCTRLO request between files, when multiple files 
are copied to the terminal. This functionality lets you use CTRL/O to 
selectively stop the display of files on the terminal screen. Executing 
a CTRL/O discards output until another CTRL/O is executed, or until the 
beginning of the next file is reached, whereupon output to the terminal 
resumes. 3 | 


@e If a PIP command line includes file transfers from magtape, PIP performs 
all file transfer operations requested on the command line in the order 
in which the files appear on the volume rather than the order in which 
they are specified in the command line. 


@ The /C option now accepts the [:date] argument. Use /C[:date] to 
include files of a certain date in the operation you specify. 


@® You can now abort a /E (WAIT) operation. 

@ In RT-11 V5, you can use the /F (PROTECTION) and /2Z (NOPROTECTION) 
options alone or for copy operations as well as for rename operations. 
It is no longer necessary to use /R (/RENAME) with /F or /Z. 


e The /Q (QUERY) option is no longer the default when deleting files, 
except when you include wildcards in the file specification. 


@e The /T (SETDATE) option now accepts the [:date] argument, so you can 
assign files dates other than the current system date. 
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The /Y (SYSTEM) option is now necessary only when you specify wildcards 
in the input file types. 


The following PIP options are new: 


/H (VERIFY) Verifies that the output file matches the 
input file after a copy operation. This option is 
invalid with /A (ASCII) and /B (BINARY). 


/I[:date] (SINCE) Includes only those files created on or after 
the specified date. 


/J[:date] (BEFORE) Includes only those files created before the 
specified date. 


/V (MULTIVOLUME) Copies files from one input volume to 
two or more smaller output volumes. 


/X Prints an informational (I) message rather than a fatal 
(F) message when PIP cannot find a file specified in 
the command line. 


See Chapter 13 of the R7T-11 System Utilities Manual for more information on 
those changes to PIP. Use the new on-line index, INDEX, to find the latest 
-information about topics related to PIP. 


2.27 QUEUE PACKAGE 


The following changes or new information applies to the queue package: 


The PRINT command is affected when you run SPOOL and QUEUE together. 
See Section 2.3.1.1 (PRINT command). 


QUEUE appends a form-feed character <FF> to the end of each copy of a 
queued file, whether the output is to a disk, a serial line printer, or 
a parallel line printer. 


The PRINT/FLAGPAGE:n option, when a value is specified for n, overrides 
the transparent spooler (SPOOL) SET SP FLAG=n command. When no value is 
specified for n with the /FLAGPAGE:n option, the value for nis set by 
the SET SP FLAG=n command. 


The SHOW QUEUE command is now processed by the RESORC /Q option rather 
than by the QUEMAN /L option. However, the /L option remains for the 
sake of compatibility. 


When QUEUE sends a job consisting of more than one input file to an 
RT-11 file-structured device, QUEUE now copies each input file to a 
separate output file with the same file name and type. The job name is 
printed in the JOBNAME field of the banner page. In RT-11 V4, all input 
files in the same job were concatenated into one output file with the 
file type .JOB. 
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@® Input files are now protected from deletion while QUEUE is copying them 
to the output device. 


@® The default number of banner pages printed when you use the /H command 
is now determined by the number of banner pages you set as the default 
with the /P command. 


@ When the input device for QUEUE operations is MT, to save time MT no 
longer rewinds between files. 


@® QUEUE’s work file is now SY:QUFILE.WRK. In RT-11 V4, the work file was 
DK: QUFILE. TMP. 


@e The following are additional QUEMAN options: 


/C[:date] (DATE) Prints only those files with the specified 
creation date. 


/I[:date] (SINCE) Prints only those files created on or after 
the specified date. 


/JI[:date] (BEFORE) Prints only those files created before the 
specified date. 


/Q Requests confirmation for each file to be included in 
the operation. QUEMAN prints the name of each file and 
pauses; you must respond Y for each file you want to 


include. 

/W Prints on the console a log of the files included in 
the operation. 

/X Allows QUEMAN to continue processing instead of halting 
when it cannot find a file specified in the command 
line. 


See Chapter 17 of the R7-11 System Utilities Manual for more information on 
those changes to the Queue Package. Use the new on-line index, INDEX, to find 
the latest information about topics related to QUEUE. 


2.28 RESORC 


The following changes or new information applies to the resource (RESORC) 
program: 


display now indicates an invalid port by displaying an asterisk (*) 
before the port number. For example, port = *n, where n = 0,1,2,3, 
indicates that port n was not installed. If RESORC option DU:/D 
displays port =n, where n = 0,1,2,3, then port n is installed. 


@® RESORC option DU:/D displays additional DU status information. The port 


@® RESORC includes a /V option. The /V option displays the release and 
version numbers for any module in the RT-11 distribution kit. 
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Use the /V option to supply the release and version numbers for any 
RT-11 modules quoted in an SPR (software performance report) submission. 


In the following example, the /V option reports the release and version 
numbers for the LS handler: 


*LS.SYS/V 
Release = V05, Version(s) = 3 


RESORC options /A, /H, and /Z now display processor support for the EAE 
(extended arithmetic element) hardware option. 


RESORC options /A and /X now display global regions in extended memory. 


RESORC options /A and /X now display a fourth column in the extended 
memory map that indicates the type of region being listed. 


The /O option now shows if SYSGEN special feature FPU (floating-point 
unit) support has been selected. 


RESORC displays the following additional processor types: 


PDP-11/53 
PDP-11/83 

PC380 

PDP-11/73A 
PDP-11/73B 
PDP-11/84, UNIBUS 


The "KT11 Memory Management Unit" display now reads "Memory Management 
Dare. 


The /A (ALL) option now provides information about the total amount of 
memory on the system, logical disk subsetting assignments, and 
organization of physical memory. 


The /C (CONFIGURATION) option now provides status information for SET 
KMON [NO]IND, SET EXIT [NO]SWAP, SET EDIT, SET SL ON/OFF, and the global 
.SCCA flag. 

The /D (DEVICES) option now accepts the optional argument dd (dd:/D), 
where dd represents the 2-letter permanent device name. You can use the 
argument dd to obtain information about a specific device. 

The /H option now includes the total amount of memory on the system. 


The /O option now also reports whether global .SCCA support was chosen 
during system generation. 


The RESORC utility now includes the following options: 
/Q Lists the contents of the queue for QUEUE or SPOOL, 


depending on which is running. The SHOW QUEUE keyboard 
command is performed by this option. 
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fs Displays information about logical disk  subsetting 
assignments. 

/X Displays information about the organization of physical 
memory: where jobs and handlers are loaded and where KMON 


and the USR will reside. 


See Chapter 14 of the RT-11 System Utilities Manual for more information on 
those changes to RESORC. Use the new on-line index, INDEX, to find the latest 
information about topics related to RESORC. 


2.29 SETUP 


The following changes or new information applies to the hardware characteristics 
(SETUP) program: 


For RI<il Vo.4C, SEIUP supports BAS options NORMAL and [NO]REVERSE. See 
Secrion 2.3.8 FOr antommacion: 


You can specify the color amber for colorl or color2 in the SETUP 
[colorl] [ON color2] command. You can create and store the exact shade 
of amber you want, using the SETUP SETCOLOR command. 


SETUP now supports two additional destinations for only the LANG:code 
mode: KB and VIDEO. The LANG:code mode is supported only for 
Professional 300 series processors. 


SETUP now supports the construction of display colors from primary 
colors, using the SETCOLOR mode. SETCOLOR mode is supported only for 
Professional 300 series processors. 


SETUP now supports the NRC (national replacement character set) for the 
Professional 300 series keyboard and video monitor. Support for each 
NRC keyboard is selected with the SETUP LANG:code command. SETUP also 
includes the following modes for more complete NRC support: COMPOSE, 
DATA, RETAIN, and TYPE. NRC support includes the use of Dead 
Diacritical keys with various NRC keyboards. There are no valid Dead 
Diacritical keys on the USA keyboard. 


SETUP now supports the COMPOSE CHARACTER key on the Professional 300 
series keyboard with the modes COMPOSE and NOCOMPOSE. COMPOSE mode lets 
you use combinations of two keyboard keys to construct characters from 
the various national replacement character (NRC) sets. 


SETUP now supports 480INTERLACE for Professional 380 series terminals. 


SETUP [NO]INTERLACE is now supported for all Professional 300 series 
video terminals. The shortest valid abbreviation for INTERLACE is INT. 
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@ SETUP supports functionality for laser printers with the LANDSCAPE and 
PORTRAIT modes. 


@® SETUP RESET now returns the text and background colors to the settings 
that were set with the most recent SETUP SAVE command. 


See the RT-11 System User’s Guide for more information on those changes to 
SETUP. Use the new on-line index, INDEX, to find the latest information about 
topics related to SETUP. 


2.30 SIPP 


The following changes or new information applies to the save image patch (SIPP) 
program: 


@e When a program you specify for a SIPP session is overlaid, SIPP reads in 
259(decimal) words of that program at a time. That is three words more 
than a single block - SIPP reads in the first three words of the next 
block too. If either block is a bad block, SIPP returns the error 
message, ?SIPP-F-Input error <dev:filenam.typ>. If you receive that 
error message, issue the command DIRECTORY/BAD for that device to find 
the bad block. For RT-11 V5.4, SIPP reads in one block at a time when 
the program is overlaid and you use the /A option, or if the program is 
not overlaid. 


@ When SIPP is used to patch a file, the creation date of the patched file 
is changed to the current system date. If no modifications are made, 
the date remains unchanged. 


® When using SIPP to create an indirect command file, the command file 
contains the command RUN SIPP rather than R SIPP. RUN SIPP lets you run 
the command file from a volume other than the system volume. 


See Chapter 22 of the RT-11 System Utilities Manual for more information on 
those changes to SIPP. Use the new on-line index, INDEX, to find the latest 
information about topics related to SIPP. 


2.31 SL 


Significant enhancements have been made to the Single-Line Command Editor 
program between V5.4 and V5.4D. See Appendix E of this manual for information. 
The following changes or new information also applies to the Single-Line Command 
Editor program: 


® Previously, SL checked only the state of bits 4 (EDIT$) and 12 (TTSPCS) 
in the JSW (job status word). SL refused to edit a command line if 
either was set. SL did not check if a program had set bit 6 (TCBITS), 
the inhibit terminal wait bit. SL could hang in the rare event that a 
program had set bit 6 and not set bit 12 and was using the .TTINR 
request in a loop to clear the input buffer. (KED is such a program.) 
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For RT-11 V5.4C, SL checks the status of bits 4, 6, and 12 of the JSW. 
If a program sets any of those bits, SL does not edit command lines. 


Possible incompatibilities remain with SL editing of command lines 
written and retrieved using requests other than .GTLIN. DIGITAL 
continues to recommend you use .GTLIN to display prompts and retrieve 
terminal input. 


If for some reason you require that SL ignore the status of bit 6 of the 
JSW, RT-11 provides the following customization patches to remove that 
functionality. Three patches are provided, one for each version of the 
SL command line editor. In the customization patches, ..SLCN, ..SLCX, 
and ..SLCM are the values for those symbols located at Section 2.7.68 in 
the file, CUSTOM.TXT. 


Removing the JSW Bit 6 Check for SL 
For SL.SYS:. 


. RUN SIPP <RET> 
* SL, SYS/A <RETO 


Base? 0 <RET> 
Offset? ..SLCN <RET> 
Base Offset Old New? 


000000 ..SLCN 010120 010020 <RET> 
000000 ..SLCN+2 277??? <CTRL/Y> <RET> 
* <CTRL/C> 


For SLX.SYS: 


» RUN ofPP <RETS 
* SLX.SYS/A <RET> 


Base? QO <RET> 
Offset? .<SuUCK <RETS 
Base Offset Old New? 


000000 ..SLCX 010120 010020 <RET> 
000000 ..SLCX+2 2727222? <CTRL/Y> <RET> 
* <CTRL/C> 


For SLMIN.SYS: 


. RUN SIPP <KET> 
* SLMIN.SYS/A <RET> 


Base? Q <RET> 
Offset? ..SLCM <RET> 
Base Offset Old New? 


000000 ..SLCM 010120 010020 <RET> 
000000 ..SLCM+2 2727??? #<CTRL/Y> <RET> 
ee TRu Ce 
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For RT-11 V5.4C, the following two SET conditions are no longer 
supported: 


SET SL VT101 
SET SL VT62 


In their place, use the following two conditions: 


SET SL VT100 
phe Sb VESZ 


As described in Appendix E, SL can edit single characters in two modes: 
INSERT mode and REPLACE mode. INSERT mode lets you place a character in 
the command line by shifting to the right all characters beyond that 
character. REPLACE mode lets you place a character in the command line 
without shifting any characters. SL is distributed in INSERT mode. You 
can alternate between INSERT and REPLACE mode by pressing CTRL/A. SL 
returns to INSERT mode at each command line. 


You can change the default mode for single-character editing from INSERT 
to REPLACE by performing the following customization patch. After 
performing the customization, you can continue to alternate between 
REPLACE and INSERT mode by pressing CTRL/A. SL returns to REPLACE mode 
at each command line. 


Three patches are provided, one for each version of the SL command line 
editor. In the customization patches, ..IRDF, ..IRDX, and ..IRDM are 
the values for those symbols located at Section 2.7.69 in the file, 
CUSTOM, TAT. 

Changing SL Character Edit Mode to REPLACE 

For SL.8Ys: 


)RUN SLEP SEET> 
*SL.SYS/A <RET> 


Base? 0 <RET> 
Offset? <<, LROUE <BEVS 
Base Offset Old New? 


000000 ..IRDF 000377 000000 <RET> 
OOD000 ...TRDPt2Z P2272? <CIRL/Y> <RETS 
eeCTRiY CS 


For SLA.0%S: 


.RUN SIPP <RET> 
*SLX.SYS/A <RET> 


Base? QO <RET> 
Offset? ..LRDX <RET> 
Base Offset Old New? 


000000 ..IRDX 000377 000000 <RET> 
O00000 ..ITRDX#2 P7727% <CTRL/Y> <RETD 
xECTRLSC> 
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For SLMIN.SYS: 


-RUN SIPP <RET> 
*SLMIN.SYS/A <RET> 


Base? Q <RET> 
Offset? ..l1RDM <RET> 
Base Offset Old New? 


000000 ..IRDM 000377 000000 <RET> 
000000 ..IRDM+2 2?7727?? <CTRL/Y> <RET> 
ee CTRL C> 


Use the new on-line index, INDEX, to find the latest information about topics 
related to SL. 


2.32 SLMIN 


The following changes or new information applies to the minimum functionality 
Single-Line Command Editor (SLMIN) utility: 


SLMIN supports only those functions contained in previous versions of 
SLMIN. However, changes have been made to SLMIN to make its limited 
functionality consistent with the current SL. For example, the SAVE and 
GET SAVE functions now use the key sequences <PF1><S> and <PF1><xX>. 
Also, you can either press <PFl><up-arrow> to recall _ the 
command-before-last or press <up-arrow> twice. 


Appendix E of this manual contains further information about SLMIN. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to SLMIN. 


2.32 SLP 


The following changes or new information applies to the source language patch 
(SLP) program: 


SLP ignores any characters that precede the start-of-update character 
(-) ain SLP command files. If SLP is unable to find the start-of-update 
character, SLP prints an error message and returns control to the CSI 
(indicated by the asterisk prompt). 


You can now update more than one file in a single SLP command file. 
Type a double slash (//) on a line by itself after the update text for 
each file. On the next line, type the command line that specifies the 
next input file to be updated and the command file name (the same 
command file that contains the update text). Then type the update text 
on the lines that follow. Type a single slash (/) on a separate line to 
indicate the end of a series of update texts. 
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@ The SLP utility includes the following additional options: 


AC [et Determines or validates the contents of the SLP input 
file or the SLP command file. Use /C to determine the 
checksum of a file. Use /C:n to verify the contents of 
a file. SLP computes the checksum for the file and 
compares the checksum to the value you specify for n. 


/N Suppresses the creation of a backup file when SLP 
updates the input file. 


See Chapter 23 of the RT-11 System Utilities Manual for more information on 
those changes to SLP. Use the new on-line index, INDEX, to find the latest 
information about topics related to SLP. 


2.34 SPLIT 
The following changes or new information applies to the SPLIT utility: 


® When you use the SPLIT /2 option, the block allocation on the output 
volumes is determined by the standard RTI-11 file size allocation 
algorithm; one-half of the largest free area. That algorithm could 
cause SPLIT to fail because of insufficient size. Therefore, when you 
use the /2 option, you should include the [-1] optional size 
specification after each output file specification. That option lets 
SPLIT use the maximum number of blocks available on the output volumes. 
For example, the following command splits the file TEST.TXT, located on 
device DK, into two files: TESTA.TXT located on device DZ0 and 
TESTB.TXT located on device DZ1: 


-SPLIT DZ0: TESTA. TXT [-1] ,DZ1: TESTB.TXT[-1]=TEST.TXT/2 


Use the new on-line index, INDEX, to find the latest information about topics 
related to SPLIT. 


2.35 SPOOL 


The following changes or new information applies to the transparent spooler 
(SPOOL) package: 


® Previously, under the XM monitor, the time-of-day string was not printed 
on flagpages unless the SP handler was loaded. For RT-11 V5.4B, SPOOL 
supports time-of-day functionality under XM without requiring that the 
SP handler be loaded. 


e If you use VM as the work device for SPOOL, you should attach VM to 
SPOOL. However, that makes VM unavailable for other use. The following 
series of commands lets you attach VM as the work device for SPOOL but 
still makes VM available for other use. These commands can be included 
in your start-up command file; if you include them, be sure to remove or 
disable any commands you now use to start SPOOL. 
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ASSIGN LS: SOO: 
ASSIGN VM7: SFD: 
FRUN SPOOL/PAUSE 
LOAD LS:=SPOOL 
LOAD VM7:=SPOOL 
ASSIGN SP: LP: 
ASSIGN SPO: LPO: 
RESUME SPOOL 


(VM does not recognize unit numbers. However, specifying a unit number 
for VM in the commands above lets the RT-11 monitor assign more than one 
function to VM.) 


@ The PRINT command is affected when you run SPOOL and QUEUE together. 
See Section 2.3.1.1 (PRINT command). 


e The PRINT/FLAGPAGE:n option, when a value is specified for n, overrides 
the SET SP FLAG=n command. When no value is specified for n with the 
/FLAGPAGE:n option, the value for n is set by the SET SP FLAG=n command. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to SPOOL. 


2.36 SRCCOM 


The following changes or new information applies to the source file comparison 
(SRCCOM) program: 


® The syntax of the SRCCOM command has changed to: 
[[out-filespec] [,SLP-filespec]=]old-filespec,new-filespec|[/options] 


The syntax element, /SLP-filespec], lets you create a differences file 
and a SLP command file in the same command line. With RT-11 V4, you 
could create only one or the other. Because you can specify both with 
the RT-11 V5 syntax in your command line, the /P option has been 
eliminated. 


@ You can now use wildcards with SRCCOM to compare multiple source files. 
See Chapter 15 of the R7-1l1 System Utilities Manual for more information on 


those changes to SRCCOM. Use the new on-line index, INDEX, to find the latest 
information about topics related to SRCCOM. 


2.37 SYSGEN 


The following changes or new information applies to the system generation 
procedure: 


® RT-11 V5.4C includes a new question in the SYSGEN dialog that pertains 
only to user-supplied device handlers. The SYSGEN dialog asks the 
following question only after you have indicated you want support for a 
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nondistributed device handler and after you have given the name for that 
device handler: 


Does your device contain an RT-11 style set option overlay (N)? 


If you override the default and respond YES, RT-11 links that device 
handler to place the SETOVR program section at an address that is evenly 
divisible by 512. 


@ For RT-11 V5.4, SYSGEN uses the following modified command line to build 
the DW handler: 


LINK/NOBITMAP /EXE: BIN: DWX.SYG/BOUNDARY:512. OBJ:DWX 
SETOVR 


® Previously, if SYSGEN needed to load a device handler, that device 
handler was not unloaded at the end of the SYSGEN procedure. For RT-11 
v5.4, SYSGEN unloads any device handlers that it loaded. 


® Multiport booting. You can select support for multiport booting for DU, 
which lets you bootstrap RT-11 from any port. Without multiport booting 
support, you Gan bootstrap RI-11 only from port 0. 


@e DU initiated bad-block replacement. Bad-block replacement provides 
substitute blocks for blocks that have caused a read or write error. 
Controllers for certain MSCP devices do not replace bad blocks. If your 
system includes the XM monitor, SYSGEN now asks you if you want DU to 
perform the bad-block replacement. 


DIGITAL recommends that you request DU bad-block replacement support if 
you are using an RC25 or the RA80/RA81 series MSCP disks. Failing to 
provide DU bad-block replacement support for those devices can cause the 
loss of data or excessive bad blocks on those devices. 


This SYSGEN option is available for only the XM monitor. 


@® SYSGEN now displays the default CSR addresses and vector addresses for 
each port you want the MSCP disk class handler (DU) to support. 


@ In system generation dialog questions that ask for CSR and vector 
addresses, the default values are displayed in parentheses. Those 
default values are now determined by the CSR and vector addresses that 
you entered in response to previous questions. The standard defaults 
are displayed, if you accepted the defaults in response to previous 
questions. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to SYSGEN. 
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2.37.1 New SYSGEN.COM Dialog Questions 


The following dialog questions have been added to SYSGEN.COM for the DU 
bad-block replacement and DU multiport support: 


109. What is the CSR (register) address for the <nth> port (nnnnnn)? 


Enter the CSR address (octal) of the <nth> port. The valid range for the CSR 
address is 160000 to 177570. The standard address is 172150. 


If you request multiple port support for DU, SYSGEN asks questions 109 and 110 
once for each port you wish to support. The default (octal) addresses appear in 
parentheses. If your system includes nonstandard addresses, respond with the 
address of each DU port. RT-11 can support up to four DU controllers (ports). 
The following list shows the default CSR addresses and vector addresses that 
correspond to each port: : | 


Port CSR (Register) Address Vector Address 


0 dag Neste 154 
1 172144 150 
2 172140 144 
3 172134 i 140 


110. What is the vector address for the <nth> port (nnn)? 

The default vector addresses appear in parentheses. If your system includes 
nonstandard addresses, enter the programmable vector address. The valid range 
for the vector address is from 100 to 474. 
111. Do you. want support for multiple port booting (NO)? 

Multiple port booting support allows you to boot RT-11l from any DU _ port. Lf 
you do not select-support for multiple port booting, you can boot RT-11 from 
only port 0. 7 
SYSGEN asks this question only if you select support for more than one port. 
112. Do you want support for DU initiated bad-block replacement (NO) ? 

Bad-block replacement is a technique in which substitute blocks are provided 
for blocks that have caused a read or write error. If your system includes an 
RC25, or an RA series device, you should request support for DU-initiated 
bad-block replacement. Controllers for those devices do not replace bad 
blocks. Enter YES if you want DU to perform the bad block replacement. 


SYSGEN asks this question only if you select the XM monitor. 


vee ae Changed SYSGEN.COM Question Numbers 


The following SYSGEN dialog question has been changed from question 110 to 
question 140: 


i al 
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110. Do you want support for banner pages (Y)? 
is now question: wy 
140. Do you want support for banner pages (Y)? 
2.37.3 Changed and New System Conditionals 
The following system conditionals have been changed: 
DUSCSR =nnnnnn ;STATUS REGISTER OF FIRST MSCP 
DUSVEC = nnn ; VECTOR OF FIRST MSCP 
DUSCS1 =nnnnnn ;STATUS REGISTER OF SECOND MSCP 
DUSVC1 = nnn ; VECTOR OF SECOND MSCP 
DUSCS2 = nnnnnn ;STATUS REGISTER OF THIRD MSCP 
DUSVC2 = nnn ; VECTOR OF THIRD MSCP 
DUSCS3 =nnnnnn ;STATUS REGISTER OF FOURTH MSCP | 
DUSVC3 = nnn ; VECTOR OF FOURTH MSCP wi 
MUSCSR =nnnnnn ;STATUS REGISTER OF FIRST TMSCP MAGTAPE UNIT 
MUSVEC = nnn ; VECTOR OF FIRST TMSCP MAGTAPE UNIT 
MUSCS1 =nnnnnn ;STATUS REGISTER OF SECOND TMSCP MAGTAPE UNIT 
MUSVC1 = nnn ; VECTOR OF SECOND TMSCP MAGTAPE UNIT 
MUSCS2 =nnnnnn ;STATUS REGISTER OF THIRD TMSCP MAGTAPE UNIT 
MUSVC2 = nnn ; VECTOR OF THIRD TMSCP MAGTAPE UNIT 
MUSCS3 =nnnnnn ;STATUS REGISTER OF FOURTH TMSCP MAGTAPE UNIT 
MUSVC3 = nnn ; VECTOR OF FOURTH TMSCP MAGTAPE UNIT \ 
The following system conditionals are new or not previously documented: 
DUSALT =nnnnnn ;STATUS REGISTER FOR FALCON DU HANDLER SUPPORT 
DUSBOO = 1 ;DU HANDLER MULTIPORT BOOTING SUPPORT 
DUSBBR =] ;DU HANDLER DYNAMIC BAD BLOCK REPLACEMENT SUPPORT 
NUSCSR =nnnnnn ;STATUS REGISTER OF UNIBUS ETHERNET 
; CONTROLLER 
NUSVEC = nnn ; VECTOR OF UNIBUS ETHERNET CONTROLLER 
| 
2.38 SYSTEM SUBROUTINE LIBRARY (SYSLIB) 
The following changes or new information applies to the system subroutine 
library (SYSLIB) : 
@ REMOVED FUNCTIONS AND SUBROUTINES 
The following functions and subroutines have been removed from the 
distributed RT-11 system subroutine library, SYSLIB. They were specific 
to FORTRAN programming and did not work without a resident FORTRAN OTS. 
They have been added to the FORTRAN IV distributed FORLIB and the 
FORTRAN-77 distributed F770TS. 
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GETSTR IFREEC INTSET 
IASIGN IGETC IQSET 

ECDER IGETSP PUTSTR 
LP EICH ILUN SECNDS 


ADDED FUNCTIONS AND SUBROUTINES 


The functions and subroutines, DATE, IDATE, RAN, and RANDU, previously 
located in the distributed FORTRAN subroutine libraries, are now located 
in SYSLIB.OBJ. See Chapter 1 for information. 


GIWRIT - The msglen parameter accepts a value equal to or greater than 
-1. Specify the -1 value for msglen to reset GIDIS. 


GTLIN - This routine now has an optional third argument that can request 
special services. The optional third argument is a string constant 
specified as ’term’ or ’plain’. The ’term’ argument takes input only 
from the console terminal, even if the program is running under the 
control of an indirect command file. The ‘plain’ argument takes 
unaltered input from the chain area and passes the input to the array 
specified by the GTLIN result argument. 


ICSTAT - This routine can now be used under the SJ monitor. 
IGTDUS - This routine now returns information on TMSCP class devices. 
ISLEEP - This routine can now be used under the SJ monitor. 
IUNTIL - This routine can now be used under the SJ monitor. 


ILUN - This routine now calls a local copy of the S$FCHNL routine. That 
copy of S$FCHNL does not assign a logical unit number (LUN) to an 
available channel if the LUN is not already assigned and thus prevents 
the channel address table from filling up. 


ISPFN subroutine calls - The ISPFN subroutine calls 
(ISPFN/ISPFNC/ISPFNF/ISPFNW) have had support added for the DU, DW, DZ, 
MU, NC, NQ, NU, and PI handlers. 


For DU, ISPFN 376 and 377 can return the following error code (in 
addition to those returned by DM): 


140000 A forced error occurred. The device controller or DU 
handler discovered bad data on a good (replaced) block. 
(Bad-block replacement was performed but no data was 
recovered. ) 


For DW, ISPFN 376 and 377 now use logical block numbers rather than 
physical block numbers in the blk argument. Therefore, to address a 
write or read to physical block zero, specify -1 for the blk argument. 
That is necessary because the physical block number of a DW device is 
one less than the logical block number. 
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For MU, ISPFN 374 (write with extended file gap) executes as ISPFN 371 
(write). 


The DU handler has had support added for ISPFN 376 and 377. For DU, 
ISPFN 376 performs a write to the specified sector, and ISPFN 377 
performs a read from the specified sector. Those writes and reads are 
not absolute; bad-block replacement and block vectoring remain in force. 
See Section 2.5.4 for information. 


See the RT-11 Programmer’s Reference Manual for more information on the system 
subroutine library (SYSLIB). Use the new on-line index, INDEX, to find the 
latest information about topics related to SYSLIB. 


2.39 SYSTEM MACRO LIBRARY (SYSMAC) 


The following changes or new information applies to the system macro library: 


.CRRG - can now return the following additional octal error codes: 


12 Global region not found 

Ls Too many global regions (none free) 

Le Global region is privately owned 

16 Global region already exists at a different base address 


.CSIGEN - For RT-11 V5.4, .CSIGEN under all monitors does not perform a 
close on any channels. When you call .CSIGEN, it performs a purge on 
channels 0 through 10(octal). If CSI errors occur, .CSIGEN purges 
channels 0 through 10 (octal). 


.CSTAT - can now be used under the SJ monitor. 


.DRBEG - An additional word (word 6) has been added to the handler 
information set up in block 0 by .DRBEG. The word has the value of a 
"NOP" instruction. The lowest 5 bits (0 through 4) of the word are used 
as bit flags to indicate the presence of entry points in block 0 for the 
fetch, release, load, and unload handler service routines. Those entry 
points are generated by the .DRPTR request. The following list shows 
the lowest 5 bits of the sixth word set up by .DRBEG and their meaning 
when set: 


Bit Meaning When Set 


Fetch entry point exists in block 0 
Release entry point exists in block 0 
Load entry point exists in block 0 
Unload entry point exists in block 0 
Reserved 
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Handlers and programs that interact with .DRBEG in a nonstandard manner 
or use the size of the code generated by .DRBEG must account for that 
additional word. 


.DRDEF - A handler attribute, VARSZ$, is for .DRDEF’s stat argument. 
Setting VARSZS (bit mask 400) indicates that the handler supports 
variable-size volumes and .SPFUN 373. 


.DREND - Two optional arguments, FORCE and PSECT, have been added to 
the .DREND programmed request. The form of the .DREND programmed 
request 1S now: 


Macro Call: name[,force=n] [,psect] 
where: 


force causes the specified value(s) from the SYSGEN Features 
Word (RMON fixed offset 372) to be entered in the handler 
vector table. For example, specifying force=4 generates 
the device timeout vector inthe table. Generating a 
vector in the handler vector table does not create 
Support in that handler for a SYSGEN feature. You can 
create multiple vectors by adding the values from the 
SYSGEN Features Word; the value is abit mask. The 
default value for force is 0 


psect forces the .DREND request to be placed in the specified 
program section at link time. Use this argument when the 
handler is built from several psects and you want to 
force location of .DREND code in the memory-resident 
section of the handler 
.DRPTR - For: RT-11 V5.4, all monitors support the .DRPTR macro. 
.ELRG - can now return the following octal error code: 
14 Global region in use 
The .ELRG programmed request will now concatenate contiguous areas of 
memory that are segmented in the allocation table, when memory is 
restored after a region is eliminated. 
.FETCH - can now be used under the XM monitor. 
.GTLIN - now includes a terminal option (.GTLIN ,,TERM=YES), which 
forces input to come from the terminal rather than from the active 


command or control file. 


.MAP - now checks to see if the specified window is already mapped. Lt 
it is, no unmapping and remapping operations are performed. 


.RDBBK - A new optional fourth parameter, BASE=n, is added to the .RDBBK 
macro for RT-11 V5.4A. Use the BASE=n parameter to explicitly assign a 
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base address to a global region. Because the BASE=n parameter 1S 
optional, you do not need to modify existing programs unless you want 
this new functionality. The .RDBBK macro now has the following syntax: 


Macro Call: .RDBBK rgsiz,rgsta,name[,base=n] 
where: 
base is the starting address of the region expressed in 32-word 
units. A value of 0 or omitted means any available base 


address is acceptable 


You cannot assign a base address value for a local region. Use the 
.CRRG reguest to assign the base address for a global region before you 
create that global region. If you assign a base address value for a 
global region that already exists at another base address, .CRRG returns 
error code 16 in ERRBYT and sets the carry bit. 


The base=n parameter sets a new bit 5 (RS.BAS) in the region status word 
only when you specify a nonzero value for n. 


You can use the base=n parameter to assign the starting address of a 
global region above system memory. (System memory is defined as the I/0 
page and that memory below the address you derive from the value stored 
in RMON fixed offset 420, S$MEMSZ.) You must specify a new symbol, 
RS.NSM, in the .RDBBK macro’s rgsta parameter. Specifying RS.NSM sets 
bit 4 (value 20) in R.GSTS of the region definition block and also 
causes bit 5 (GR.NRF) in the global region control block status byte 
(GR.STA) to be set. GR.NRF stops return of the global region’s 
allocated memory to the system free memory list when that global region 
is eliminated. No error checking is performed when the base=n parameter 
is used in this manner. 


For RT-11 V5.4A, a sixth word (R.GBAS) has been added to the region 
definition block set up by the .RDBBK macro. R.GBAS resides at offset 
12(octal), immediately following R.NAME. R.GBAS contains the base 
address for the global region described by that region definition block. 
The structure of a region definition block is now: 


R.GBAS is referenced by the monitor only when the RS.BAS bit is set. 
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RS.BAS is set only when you specify a nonzero value for n in the new 
BASE=n parameter. Therefore, you do not need to modify existing 
programs because of this new word. 


e If you are using the .READ, .READC, or .READW programmed requests 
under the SJ monitor, read the restriction at the beginning of 
Becton Sylsz< 


® .SAVESTATUS - For RT-11 V5.4, you can use the .SAVESTATUS request 
for a device channel that is opened with the .ENTER request, so long 
as that device is both special directory structured and write only. 
The .ENTER request remains an invalid way to open a channel for which 
you intend to use .SAVESTATUS for all other types of devices. You 
can also use the .LOOKUP request and .SAVESTATUS for special 
directory-structured devices, so long as the device is write only. 


A device is recognized as special directory structured and write only 
when the SPECLS and WONLYS bits are set in the $STAT entry table in 
the resident monitor (RMON). For RT-11 V5.4, the only devices that 
are special directory structured and write only are LP, LS, and SP. 


® .SCCA - has been modified to include global .SCCA support. Global 
.SCCA support lets you prevent double CTRL/C aborts by causing the 
system to ignore all CTRL/C characters issued from the terminal. 


@e .SPFUN - If you are using the .SPFUN programmed request under the SJ 
monitor, read the restriction at the beginning of Section 3.1.2. 


.SPFUN has had support added for the DU, DW, DZ, MU, NC, NQ, NU, and 
PI handlers. 


For DU, .SPFUN 376 and 377 can return the following error code (in 
addition to those returned by DM): 


140000 A forced error occurred. The device controller or DU 
handler discovered bad data on a good (replaced) block. 
(Bad-block replacement was performed, but no data was 
recovered. ) 


For DW, .SPFUN 376 and 377 now use logical block numbers rather than 
physical block numbers in the blk argument. Therefore, to address a 
write or read to physical block zero, specify -1 for the blk argument. 
That is necessary because the physical block number of a DW device is 
one less than the logical block number. 


For MU, .SPFUN 374 (write with extended file gap) executes as .SPFUN 371 
(write). Write with extended gap functionality is not supported by 
TMSCP magtapes. 


The DU handler has had support added for .SPFUN 376 and 377. For DU, 
.SPFUN 376 performs a write to the specified sector, and .SPFUN 377 
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performs a read from the specified sector. Those writes and reads are 
not absolute; bad-block replacement and block vectoring remain in force. 
See Section 2.5.4 for information. 

@ .TWAIT - can now be used under the SJ monitor. 


e If you are using the .WRITE, .WRITC, or .WRITW programmed requests under 
the SJ monitor, read the restriction at the beginning of Section 3.1.2. 


See the RI-11 Programmer’s Reference Manual for more information on the system 


macro library (SYSMAC). Use the new on-line index, INDEX, to find the latest 
information about topics related to SYSMAC. 


2.40 TRANSF 
The following changes or new information applies to the TRANSF utility: 
® For RT-11 V5.4C, TRANSF progressively restores packet size after 
continued success from transmitting at a reduced packet size. See VTCOM 


im £his section for more information. 


Use the new on-line index, INDEX, to find the latest information about topics 
related to TRANSF. 


2.41 UCL 


The following changes or new information applies to the user command linkage 
(UCI) Geri 


@ It is a documented restriction that you cannot call indirect files 


(@filename) in a command definition. The keyboard monitor (KMON) 
preprocesses characters following an @ sign for expansion as part of its 
command processing. However, you can edit the UCL data file to place 


the @ (or $@) sign ahead of an indirect file name and thereby bypass the 
KMON preprocessing. 


For the purpose of this example, assume you want to create a command 
named DO that will run the start-up command file STARTX.COM. Because 
STARTX.COM is an indirect command file, you want to include the prefix 


o@. 


Use the following procedure to enable UCL to run STARTX.COM when you 
type the command DO: 


1. Place the following command syntax in your UCL data file: 


DO :== SSSTARTX.COM 


2. You must now edit your UCL data file to replace the $$ prefix on 
STARTX.COM with the $@ prefix. Assuming KED (or KEX) is your 
default editor and UCL.DAT is your UCL data file, issue the command: 


EDIT UCL.DAT 
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3. Use the KED advance-one-word keypad sequence (<4><1>) to advance 
through your UCL data file, until the cursor rests at the beginning 
of the word SSSTARTX.COM. 


4. Advance the cursor two characters, delete the $ sign and replace it 
with an @ sign. The word should now appear as S@STARTX.COM. 


5. Exit from KED. Now, when you type the command DO in response to the 
monitor prompt, you run the indirect command file STARTX.COM. 


If the indirect file you want to run is an IND indirect control file, 
FOO.COM, for example, you enter the UCL command as: 


DO :== SFOO.COM 


Using the procedure described above, you edit your UCL data file to 
change the $ sign to an @ sign. The command DO then runs the IND 
control file named FOO.COM. 


For RT-11 V5.4, you can create and issue UCL commands in upper-, lower-, 
or mixed case. The case you use to create the UCL command is stored (as 
entered) in the UCL data file, and the command’s case is passed to KMON 
in the chain area as stored. 


If you change the name of the UCL data file, you can use the following 
customization patch to match the name displayed by error messages with 
the name you chose for the data file. 


Changing UCL Data File Error Message Name 


As distributed, the name displayed with UCL error messages is UCL 
(2UCL=). You can change that 3-character name to any three characters 
you want, using the following customization patch. This is particularly 
useful if you have changed the name of the UCL data file. 


In the customization, ..ERR is the symbol for a value located at Section 
2.7.56 in the file CUSTOM.TXT, and nnn is the new 3-character name. 


.RUN SIPP <RET> 
*UCL.SAV/A <RET> 
Base? 0 <RET> 


Offset? ..EBRR <RET> 

Base Offset Ones New? 
000000 ..ERR Seger? *A <RETS 
000000 ..ERR <?> <RET> 
000000 ..ERR+1 <U> sAn <RET> 
000000 ..ERR+2 <C> can <RET> 
000000 ..ERR+3 <> >An <RET> 
000000 ..ERR+4 <-> <CTRL/Y> <RET> 
e<CTRL/C} 
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@ The data structure for the data file UCL.DAT has been redesigned. Data 
files created prior to RT-11 V5.2 must be manually recreated. 


® UCL supports the SHOW COMMANDS command, which displays command 
definitions on the console terminal. SHOW COMMANDS also supports the 
/PRINTER and /OUTPUT:filespec options. 


@® The CSI (command string interpreter) interface is not supported for UCL; 
do not issue the R UCL command. 


® The maximum number of user-defined UCL commands in the command table in 
the UCL data file can be changed (increased or decreased) from 
31 (decimal) to a maximum you specify. 


® You can optimize the UCL utility by combining the save image program 
(.SAV) file and the data (.DAT) file. 


@e Informational messages, in the form ?UCL-I-, have been removed from UCL. 
Warning prompts, in the form Are you sure?, have also been removed. You 
no longer need to verify your wish to replace or delete a command, 
Execution of a command to define, redefine, or delete a UCL command is 
indicated by the appearance of the monitor prompt (.). 


See the RT-11 System User’s Guide for information on using UCL. Use the new 
on-line index, INDEX, to find the latest information about topics related to 
UCL. 


2.42 VWTCOM 


The following changes or new information applies to the virtual terminal 
communication (VICOM) package: 


@® Previously, VICOM and TRANSF reduced the transmission packet size by 
half for each error that occurred during a data transmission. 
Transmission errors successively halved the packet size from a maximum 
of 512 bytes to a minimum of 16 bytes. The packet size could decrease 


in size but not increase in size. Therefore, momentary transmission 
problems could significantly lengthen the time required to transmit 
data. 


For RT-11 V5.4C, VICOM and TRANSF progressively restore packet size 
after continued success from transmitting at a reduced packet size. 
This process is dynamic; errors halve packet size, while success 
progressively restores packet size. The maximum and minimum packet size 
remains respectively at 512 and 16 bytes. 
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The process of packet size reduction and restoration is controlled by 
the program sending the data. Data transfers from the RT-11 stand-alone 
processor to a host processor are controlled by VTICOM. Data transfers 
from a host processor to the RT-11 stand-alone processor are controlled 
by TRANSF. 


For RT-11 V5.4D, you can change the character you type to VICOM to enter 
command mode. The default command mode character for VICOM is <CTRL/P>. 
You can change the character CTRL/P to any you choose by using the 
following customization patch. 


Changing the VICOM Command Mode Character 


The following customization patches let you alter the character that 
must be typed to VICOM to enter command mode. The default command mode 
character for VICOM is <CTRL/P>. 


In the customization, ..LCCH is the symbol for a value located at 
Section 2.7.70 in the file CUSTOM.TXT, and nnn is the octal value for 
the new default command mode character. That new character cannot be 
printable and cannot be a character that RT-11 intercepts and processes, 
such as <CTRL/F>, <CTRL/B>, <CTRL/X>, <CTRL/O>, and So on. 


For VICOM.REL: 


KR DLPE <RET?S 
*VTCOM.REL <RET> 
Base? Q <RET> 
Offset? ..LCCH <RET> 


Base Offset Old New? 

000000 ..LCCH 000020 \ <RET> 

Base Offset Old New? 

000000 Pare BG Bs 020 nnn <RET> 
000000 Re Ads we 000 <CTRL/Y> <RET> 
*<KCTRL/C> 


For VTCOM.SAV: 


oles ARG 
*VTCOM.SAV <RET> 
Segment? 1 <RET> 
Base? 0 <RET> 
Offset? ..LCCH <RET> 


segment Base OLiset Old New? 

000001 000000 «.LCCHR Q000Z0 \ <RET> 
segment Base Offset Old New? 

000001 000000 ,2uCGH 020 nnn <RET> 
000001 000000 <7bCCHTL O00 <CTRL/Y> <RETS 
*<CTRL/C> 
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@® To run VICOM.REL under XM is inefficient; you must run VTICOM.SAV. For 
RT-11 V5.4, if you run VICOM.REL under the XM monitor, VICOM returns the 
message, ?VICOM-F-Use XM version, VTCOM.SAV. 


e If you attempt a VICOM operation that uses a volume that is invalid (not 
initialized, for example), VICOM returns the error message, 
?VTCOM-F-Invalid directory. Make the volume a valid RT-11 volume and 

_ retry the VICOM operation. 


@e Previously, the modem’s Clear To Send signal controlled whether VTICOM 
reported a connection as established or lost. For RT-11 V5.4, the 
Carrier Detect signal controls the status of the connection report. The 
connection report is the same and remains valid for all supported 
modems. 


e Transfer speed enhancements were made to VICOM for a previous release of 
RT-11. $VICOM sends data at the interface interrupt speed. That 
transfer speed can be too fast for the host terminal service to process. 
A symptom is a beeping terminal. To compensate, slow down the baud rate 
or let VITCOM adjust the transfer rate, using retries and reduced packet 
size. 


@ VTICOM for RT-11 V5.2 cannot be used with earlier versions of the XC and 
XL device handlers. The XC and XL device handlers for V5.2 cannot be 
used with earlier versions of VICOM. Attempts to do so return an error 
message. 


@ VICOM.REL and VICOM.SAV now support the Mini-Exchange, using the VTCOM 
command SELECT. 


e The shortest valid abbreviation for the SELECT command is SEL and for 
the SEND command is SEN. 


@ VICOM includes a HANGUP command. 


@e Enhancements made to the file transfer code in VICOM can increase the 
speed of a transfer through more efficient use of the serial line. 


@® The VICOM SEND command sends ASCII files at two speeds: SLOW or FAST. 
The distributed default speed is FAST. Use SLOW if the host terminal 
service does not support XON/XOFF and FAST if it does support XON/XOFF. 
A customization in the RT-1l Installation Guide lets you set the VTCOM 
SEND command speed. 


@ The customization patch used to set a default dial string for the VTCOM 
DIAL command now lets you specify the actual character itself, rather 
than the octal ASCII value for the character. 


See the RT-11 System Utilities Manual for a complete description of using VTCOM. 
Use the new on-line index, INDEX, to find the latest information about topics 
related to VTCOM. 


CHAPTER 3 


CURRENT RESTRICTIONS AND CORRECTED PROBLEMS 


This chapter lists the current restrictions, corrected software problems, and 
corrections and additions for the RT-11 documentation set. 


You can use the on-line indéx utility, INDEX, and the on-line help utility, 
HELP, to find more information on topics described in this chapter. 


3.1 CURRENT RESTRICTIONS 


When running RT-11 V5.4D, observe the following restrictions. 


3.1.1 Handler Restrictions 


The following restrictions apply to RT-11 handlers. 


3.1.1.1 General Handler Restrictions - The following restrictions apply to all 
RT-11 handlers: 


@e You can hang or crash your system if you unload a device handler that 
has outstanding I/O requests from a job. You must stop the job that is 
using that handler before you unload the handler. 


@ You must LOAD any device handler that is used by a system job. For . 


example, if your system device (SY) uses a different handler than your 
data device (DK), you must LOAD the data device handler before running 
any system job that uses that data device. You should LOAD any device 
handler that is used by a foreground job. 


® Handlers built by RT-11 V5.3 (or subsequent) or distributed with V5.3 
(or subsequent) should not be run on and cannot be built by earlier 
versions of RT-11. 


@® You can encounter problems when customizing the SD, SL, or ST handler 


file name suffix. DIGITAL does not recommend the use of any suffixes 
other than X for the XM monitor or M for RTEM-11 with those handlers. 
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@ Device handlers must now be linked with the /NOBITMAP option. 


3.1.1.2 Specific Handler Restrictions - The following restrictions apply to 
only the indicated handler: 


DU 


LP/LS 


MM/MT 


Support for DU multiport booting requires a V5.3 (or subsequent) DU 
handler running under a V5.3 (or subsequent) monitor. 


Under the XM monitor, the DU handler (DUX) cannot be renamed and then 
used concurrently with the renamed handler. You cannot, for example, 
rename DUX to DAX and use DUX and DAX at the same time. 


DU bad-block replacement is supported under only the XM monitor. 


Issuing a PRINT command to the LP or LS handler while the printer is off 
line or XOFFed (LS only) causes the handler (and possibly the system) to 
appear hung. Place the printer on line or clear the XOFF condition, or 
press CTRL/C twice to free the handler. 


DIGITAL recommends that you do not use the command SET LS NOHANG. When 
you use SET LS NOHANG, printers with large buffers can cause the handler 
to abort the I/O request before they are through printing. 


The SET MM/MT NOODDPAR command is provided only for media compatibility 
with other operating systems; use it only to exchange magtapes with 
another system that requires even parity. Do not set even parity (SET 
MM/MT NOODDPAR) on MM or MT 9-track magtapes for use with DIGITAL 
controllers. 


Magtapes written for DIGITAL controllers require at least one nonzero 
bit per byte. Setting odd parity ensures that at least the parity bit 
is set for a null byte. Setting parity to even (NOODDPAR) violates that 
requirement. DIGITAL controllers can then either lose (fail to 
distinguish) that null byte or set bit 4, which stores an octal value of 
020 with bad parity. The MM and MT handlers cannot distinguish bytes 
with created parity errors from those with true parity errors, which 
makes magtapes created by BUP, DUP, and PIP unreadable. 


Also, you cannot perform magtape-to-magtape copies on drives controlled 


by MM when you have set MM to NOODDPAR. Doing that produces immediate 
unrecoverable errors, depending on the utility program used. 
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® DIGITAL recommends you LOAD the MU handler when performing BUP or COPY 
operations with TMSCP magtape devices. 


NC, NQ, and NU 


@e You must explicitly load the NC, NQ, and NU handlers, using the LOAD 
command. You cannot fetch those handlers. 


TT 
® The SET TT NOSCOPE condition has no effect if you are running the 
Single-line (SL) command editor. You must explicitly SET SL OFF if you 
want to set your terminal to NOSCOPE. 
® Unit numbers other than 0 are not supported for TT devices. I/O 
requests to TTn, where n is other than 0, return a hard error. 
VM 
® The VM handler (under SJ and FB) cannot be used on a PDP-11/23 processor 
with MSV1l1 memory, strapped for a 2K-word I/O page, unless you perform 
customization patch 2.7.21, described in the RT-11 Installation Guide. 
XC and XL 


® You should explicitly load the XC and XL handlers, using the LOAD 
command. You should not fetch those handlers. If VICOM is run as a 
system job, you must load them. 


3.1.2 Monitor Restrictions 
The following restrictions apply to RTI-11 monitors: 


@® You should not use I/O programmed requests (for example, 
.READ/.READC/.READW, .WRITE/.WRITC/.WRITW, and .SPFUN) within completion 
routines under the SJ (single-job) monitor. You should also not’ use 
those I/O programmed requests within device handlers under the SJ 
monitor, even when such requests follow a .SYNCH request, because that 
induces a race condition that under certain circumstances can hang the 
system. 


That race condition is not a result of RT-11 V5.4B development; however, 
it was only recently discovered. The system hang is most probable when 
using 1/0 programmed requests in completion routines with the VM device. 
Although less probable, using 1/0 programmed requests in completion 
routines under SJ can hang the system with any device. 


Therefore, any critical application running under SJ should not use 1/0 
programmed requests in completion routines with any device. 
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When you run under the XM monitor and you use any of the following 
handlers, you must use the LOAD command to explicitly load them: BA, 
CT, DD, NC, NQ, NU, SD, and ST. You cannot fetch those handlers. 


Do not call ISLEEP from within a completion routine when running under 
the SJ monitor, because that can hang the program containing the 
completion routine. 


VECTOR addresses 470 and 474 are reserved for internal use by RT-11. 


FRUNing or SRUNing a privileged foreground job containing extended 
memory overlays causes the system to crash. Do not FRUN/SRUN privileged 
foreground jobs containing extended memory overlays. 


Privileged foreground jobs cannot use virtual overlays. Any attempt to 
do so can crash the system. (That rule does not apply to virtual 
foreground jobs; they run correctly with any type of overlay.) 


FORTRAN virtual arrays and VM using extended memory cannot be used 
concurrently when running under the SJ and FB monitors. 


If you pass more than one command through a special chain exit, you can 
call an indirect command file only as the last command in that series of 
commands. 


3.1.3 Peripheral Device Restrictions 


The following restrictions apply to the indicated peripheral devices: 


DEQNA Ethernet Controller 


All DEQNA controllers used with RT-11 should be at revision E1/E2 or 
higher. 


All DEQNA Ethernet controllers used with RT-11 must have the sanity 
timer disabled. The DEQNA sanity timer reboots the RT-11 system after a 
period of time under certain circumstances. If you suspect your DEQNA 
Sanity timer is enabled, consult your DEQNA user documentation for 
information about disabling it. 


Magtape Drives in General 


The following restrictions apply to all magtape devices. For individual magtape 
device restrictions, see the section for that individual device. 


® Use the .CLOSE request rather than the .PURGE request when you terminate 


a program that performs I/O operations to any RT-11 magtape device. See 
Section 3.3.4.11, Magtape Handlers, for information. 
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A directory listing of a file larger than 42767(decimal) blocks on any 
magtape shows a file size of 0Q. All magtape handlers incorrectly 
translate numbers greater than 42767(decimal) block file size to ASCII 
2 (The number 42767 is a correct number; it is not a typographical 
error.) You cannot use the distributed MDUP programs with LSI-11 
processors. Use the procedure described in the MDUP section of Chapter 
2 to build an SJ monitor and an MDUP program that you can use with your 
LSI-11 processor. 


RC25 Disk Drive 


When uSing an RC25 dual drive configuration (4 platters), turn on both 
RC25 drives before booting RT-11. Turning on the second RC25 drive 
after booting RT-11 requires a reboot to make the second RC25 available. 


RODX3 Disk Controller (DU) 


The RQDX3 disk controller cannot read data written to RD5x disks by the 
RQDX1 or RQDX2 controller. Therefore, if you upgrade from the RQDX1 or 
RQDX2 controller to the RQDX3 controller, you must reformat your RDox 
disk. Perform the following procedure: 


1. Back up the disk written by the RQDX1 or RQDX2 controller, using 
that controller. 


2. Format the disk, using the RQDX3 controller. 


3. Restore your data to the disk. 


RX33 Diskette Drive 


Formatting RX33 diskettes locks the DU controller for that RX33 diskette 
drive; all other devices on that controller are unavailable. Do not, 
for example, attempt to acquire data on a device being run by a DU 
controller while you are formatting a diskette on an RX33 drive on the 
same controller. | 


TK50 Magtape Drive 


The TK50 magtape device is designed to perform optimally when streaming. 
The performance degrades significantly when not streaming. You will 
notice that performance degradation when operating the TK50 in a 
start/stop mode. 


The TK50 magtape drive may not immediately recognize a change in the 
write protection status of a magtape cartridge when that cartridge is 
loaded in the drive. A change in magtape cartridge write protection is 
not recognized until a significant event occurs. A significant event 
would be, for example, a change in the magtape track being read or 
written. 
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You can guarantee recognition of a change in write protection status by 
unloading the magtape cartridge, changing the write protection on that 
cartridge, and then loading it. You do not need to remove the magtape 
cartridge from the drive. Push the red load/unload switch (to unload), 
wait for the green light to come on, change the write protection on the 
magtape cartridge, and then push the red load/unload switch (to load). 


@ You may experience a delay in receiving the monitor prompt (.) when you 
abort operations on the TK50 magtape drive by issuing a double CTRL/C. 
The TK50 magtape drive might not relinquish control to the monitor until 
it finishes performing an operation that it independently initiated. 
Whether you receive the monitor prompt immediately depends on the 
operation being performed by the TK50 when you abort. 


For example, when you instruct the TK50 to back up 10 or more records, 
it accomplishes that operation by rewinding to BOT (beginning of tape) 
and spacing forward to the desired record. If you abort that operation 
while the TK50 is rewinding to BOT, you will not receive the monitor 
prompt until the TK50 has reached BOT. However, if you specifically 
instruct the TK50 to rewind to BOT and then abort that operation, you 
receive the monitor prompt immediately. 


Similarly, the TK50 reads calibration tracks as the first operation on a 
newly mounted magtape cartridge. If you abort the TK50 while it is 
reading those tracks, you will not receive the monitor prompt until the 
calibration is complete. 

TS11, TSU05, TSVO5, and TK25 Magtape Drives 


@e Issuing the INITIALIZE MS: command without a tape in the drive can 
crash the system. 


TU58 DECtape ITI 
@e If your system load is so great that the TU58 DECtape II cannot be used 


successfully as the system device on a 38.4K baud line, change your 
hardware to lower the baud rate. 


3.1.4 Processor Restrictions 
The following restrictions apply to the indicated processors: 


@e A system generated to support DU multiport booting cannot be run on an 
SBC-11/21 (Falcon processor). 


@® When running RT-11 on an SBC-11/21, the SBC-11/21 must be jumpered for 
map selection 0, as specified in the SBC-11/21 Falcon User’s Guide. 


@e LS, to be used on the available SLU serial port of an SBC-11/21 or 
SBC-11/21 PLUS processor, must be rebuilt with LSSPRI = 5. 
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XL, to be used on the available SLU serial port of an SBC-11/21 or 
SBC-11/21 PLUS processor, must be rebuilt with XLSPRI = 5 or XLSSBC = 1. 


DD, to be used on the available SLU serial port of an SBC-11/21 or 
SBC-11/21 PLUS processor, must be rebuilt with DDSPRI = 5. 


3.1.5 Programmed Request Restrictions 


The following restrictions apply to programmed requests: 


The following requests and subroutines perform I/O contiguously from the 
specified buffer starting address: .READx, .WRITx, IREADx, IWRITx, 
JREADZ, JWRITs, .SPFUN 3/76 and .SPYUN 377, ISPFN 376 and ISPFN 377. ie 
the specified buffer spans a discontiguously mapped page boundary, 1/0 
is performed outside the mapped buffer, and no error message is 
returned. 


3.1.6 Utility Restrictions 


The following restrictions apply to the indicated RT-11 utilities: 


BUP 


DBG-11 


If you want to send the directory of a backup volume to your printer, 
use the exact command, DIRECTORY/BACKUP/PRINTER. Do not use the command 
DIRECTORY/PRINTER/BACKUP, which fails because KMON incorrectly appends 
the /L (DIRECTORY) option to the output file. 


All BUP CSI options are position dependent; they must be coupled with 
the input file. Coupling any CSI option with the output file returns an 
error message. 


Do not use BUP to back up DL or DM non-RT-11 file-structured volumes. 
DL and DM volumes contain bad-block replacement tables in their home 
block. Do not use BUP to back up any other volumes that contain 
bad-block replacement tables in their home block. (Only DL and DM among 
DIGITAL volumes are affected by this restriction.) 


BUP does not support 100 in/sec streaming for the TS05 magtapes under 
the XM monitor. BUP does support 25 in/s streaming for the TSOQ5 
magtapes under the XM monitor. 


When you run BUP under the FB monitor, unload any unnecessary foreground 


jobs to gain more memory, which produces more efficient magtape 
streaming. 


All terminals used with DBG-11 must have hardware tabs. 


DUP 
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e Before you unload DBG-11, be sure to remove all breakpoints set in 


permanent areas of memory, such as the monitor and loaded handlers. 
Unloading DBG-11 before removing breakpoints in those areas could cause 
unpredictable results. 


The command COPY/DEVICE cannot be used by RT-11 V5 to copy images from 
magtapes to disks, when the images were copied to the magtape, using 
RT-11 V4. Use RT-11 V4 for that operation. 


If you use the RT-11 V5 command INIT/VOL to assign a volume ID, that 
volume ID will not be displayed when you issue the command DIR/VOL under 
RT=li V4, 


ERROR LOGGER 


GIDIS 


@ You cannot run more than one Error Logger, and the job name for that 


Single Error Logger must be ERRLOG. 


Error logging is not supported for magtape devices. 


You cannot make any change in interlace mode while running GIDIS; any 
change must be made before running GIDIS or after you exit from GIDIS. 


Entering an invalid device or file name for the IND .TESTFILE directive 
returns only a syntax error and terminates IND. IND cannot determine 
the exact cause of the error. 


IND control files cannot include an indirect command file that calls 
another IND control file. 


You cannot place CSI commands or DCL commands that require more than one 
line in IND control files. To execute multiline CSI commands and 
multiline DCL commands from an IND control file, create an indirect 
command file that contains the command and call the command file from 
the control file by using the $@ syntax. 


With single-line CSI commands, you can use CCL commands instead of 
creating and calling the indirect command file, which saves space in the 
IND control file. 


For example, the following IND control file executes a CSI command by 
creating an indirect command file, then calling the indirect command 
file: 

pEE, PIP’ sgh od 

.OPEN SECOND .COM 

DATA K Pi 

.DATA A.MAC=B.MAC 

.DATA *C 

. CLOSE 

$@SECOND 

vie ghee as 
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LIBR 


LINK 


MACRO 
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Instead of creating the indirect command file, you can achieve the same 
result by using the following CCL command example: 


.IFT PIP PIP A.MAC=B.MAC 


You cannot run the BATCH processor and IND simultaneously. You must 
have SET KMON NOIND in effect to run BATCH. Also, you cannot run BATCH 
from an IND control file. 


When using nested logical disks, the primary disk must have a lower unit 
number than the nested disk. For example, if logical disk B is located 
within logical disk A, A must have a lower unit number than B. Logical 
disk A can be LDO and logical disk B can be LD1, but not vice versa. 


Similarly, you cannot mount a logical device located within the same 
logical unit. For example, the following mount command attempts (but 
fails) to mount logical disk LD3:FOO.DSK that is located within logical 
unit LD3: 


MOUNT LD3: LD3:FOO.DSK 


However, the following command will work because it obeys the nested 
logical disk rule: 


MOUNT LD3: LD2:FOO.DSK 


The LIBR /X option for creating multiple definition libraries is 
included in RT-11 only for compatibility with the RSTS operating system. 
DIGITAL recommends you do not use the LIBR /X option under the RT-11 
operating system. 


Do not link programs using both the /R and /V:n options. Those options 
specify a REL format (foreground or system job environment) and an 
extended memory overlay structure. Such a program is not’ supported 
under RT-11 and can cause a system crash. 


The maximum address space of a program without virtual overlays is 
65534(decimal) bytes or 32767(decimal) words, which is one word less 
than 32K words. 


The maximum virtual address space of a program with virtual overlays is 
65472 (decimal) bytes or 32736(decimal) words, which is 32(decimal) words 
less than 32K words. 


In MACRO-11 programs, all variable names of the form ...Vx are reserved 
by DIGITAL. 


so 


QUEUE 


RESORC 


SETUP 


SIPP 
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In MACRO-11 programs, all macro names of the form ...CMx are reserved by 
DIGITAL. 


Even when .ENABL MCL is in effect, you must manually .MCALL any macros 
whose names conflict with names in the MACRO-11 permanent symbol table 
(such as .PRINT). 


You cannot use the distributed MDUP programs with LSI-11 processors. 
Use the procedure described in MDUP Section 2.23 to build an SJ monitor 
and an MDUP program that you can use with your LSI-11 processor. 


QUEUE protects files until it has placed them in the queue. A permanent 
feature of RT-11 is that a file cannot be copied to a device that 
contains a protected file with the same file name. Therefore, QUEUE 
cannot be used to transfer a file to a device that contains a file with 
the same file name. 


When both SPOOL and QUEUE are running, QUEMAN options /H and /N return 
an invalid option error message. Those options conflict with SPOOL 
(PIP) options, and KMON assigns SPOOL precedence over QUEUE. 


Also when both SPOOL and QUEUE are running, PRINT options /PROMPT and 
/NAME return an invalid option error message. Those options are 
specific to QUEUE, and KMON assigns SPOOL precedence over QUEUE (KMON 
treats the options as SPOOL options). 


SHOW MEMORY displays only approximate values. Memory components shown 
include memory tracking overhead locations, which are not part of the 
components. Consequently, the values shown can be as much as 32 words 
in error. 


Set an LA210 or LA100 printer to AUTO mode before issuing it SETUP 
commands. 


Do not issue SETUP COLOR commands to monochrome monitors; such commands 
will overdrive your monitor, making the screen unreadable. Reboot the 
system to correct that condition. Do not include SETUP COLOR commands 
in command files that might be run on processors that have a monochrome 
monitor. 


If you use SIPP to patch or examine an overlaid program without using 
the /A option and SIPP reads to the end of a disk, SIPP returns the 
error message, ?SIPP-F-Input error <dev:filenam.typ>, and does not read 
the last block on the disk. 
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You cannot use SL to edit the continuation line of a DCL KMON command. 


The single-line command editor (SL) cannot be used with foreground or 
system jobs. 


When using the single-line (SL) editor, if you SET TT CRLF you must also 
set your terminal to wrap. Set your terminal to wrap, using the SETUP 
TT WRAP command, or use the terminal hardware setup feature. 


The single-line editor (SL) does not support the use of control 
characters as input data. Before you run a program that must receive 
control characters as input data in line mode, you must turn off SL. 
Use the SET SL OFF command or have your program set the EDITS bit (bit 
4) in the JSW. 


That restriction does not apply to programs that use special mode input. 


When the single-line editor (SL) is enabled, the command COPY TT: 
filespec does not work. 


Problems can occur with program prompting with the single-line command 
editor (SL) set ON. Although SL set ON prompts properly when used with 
programs that use .GLIN for terminal input, SL may not prompt properly 
when used with various combinations of .PRINT and .TTYIN, or when 
prompts contain control characters such as line feeds or carriage 
returns. No correction is available for that problem; however, the 
DIGITAL-recommended work-around is to SET SL KMON (rather than SET SL 
ON) or have your program set the EDITS bit (bit 4) in the JSW. 


SL and BATCH cannot be used together. 


You cannot run the current version (V2.1) of DECnet-RT and SPOOL at the 
same time. Together with probable low-memory constraints, a conflict 
occurs with the RMON fixed offset used by those two jobs. 


The transparent spooler (SPOOL) supports only a single device: SPQ or 
SP. Attempts to SET conditions for SPn, where n is other than 0 or 
omitted, can cause SPOOL to hang. 


When you perform a SYSGEN and request no SPOOL banner page support, 
various SET conditions appropriate for SPOOL banner page support are 
made invalid. Also, you cannot change the default SET conditions FORMO 
and ENDPAG=0. If you want the SET condition NOFORMO or ENDPAG=n, where 
nis other than 0, use the distributed SP handler. 
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TRANSFER 


@® TRANSF.TSK (TRANSFER for RSX operating systems) requires the RMSRES and 


DAPRES libraries to be installed on the host PDP-11 processor. 


@e Run TRANSFER only from a host that you have logged onto using VTCOM. 


UCL 


Attempting to run TRANSFER from a host you have logged onto using DECnet 
will hang the system. That is, do not use the SET HOST command to log 
onto a host and then attempt to run TRANSFER from that host (across the 
DECnet) . 


If you define a UCL command as a save image (.SAV) file, the save image 
file returns an error message. You must first disable the CCL command 
processor because it attempts to run the UCL command definition as a CCL 
command. For example, defining the following UCL command produces the 
indicated error message: 


.PIP :== R PIP 
?CSI-F-Invalid command 


You can disable CCL command processing, using customization patch 2.7.63 
in the R7J-11 Installation Guide. Carefully study the instructions for 
using that customization patch because making a mistake can disable 
other or all command processors. 


If you define a UCL command as a valid DCL command, the keyboard monitor 
(KMON) returns an error message. KMON tries to execute the UCL command 
definition as a DCL command. Use UCF if you want to redefine a valid 
DCL command. 


The CSI (command string interpreter) interface is not supported for UCL; 
do not issue the R UCL command. 


VBGEXE (unsupported) 


@ You cannot run DUP with the /O option (BOOT command), IND, RESORC, or 


VICOM 


SPOOL from VBGEXE. 
The program cannot contain interrupt service routines. 


The program cannot use the following programmed requests: . FORK, 
.INTEN, .MFPS, and .MTPS. 


The program can use only the .PEEK, .POKE, .GVAL, and .PVAL programmed 
requests to access the kernel address space (for example, monitor data 
and the I/O page). 


Some systems, such as those using MICOM lines, require more than one 
BREAK command to gain access to the host processor. VTICOM does not 
support multiple short BREAK commands. 
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3.1.7 Current Restrictions When Using the Multitemminal Special Feature 


The following restrictions apply to systems with the multiterminal special 


@® Do not use ODT or the hard I/O versions of the DBG-11 pseudohandlers 


(SDH.SYS or SDHX.SYS) while running RT-11 under a multiterminal monitor 
that was generated with multiterminal timeout support. If you use them 
under such a multiterminal monitor, characters may be echoed twice on 
your console terminal screen. Characters can be echoed by both the 
debugging utilities and the monitor. 


Also, using ODT, SDH.SYS, or SDHX.SYS under that monitor causes 
characters you type as debugging commands to be placed in the KMON 
command buffer. When you exit from them, KMON attempts to execute those 
characters as a command, and KMON can return an ’invalid command’ error 
message. 


Use instead VDT or the DBG-11 soft I/0 pseudohandlers (SDS.SYS or 
SDSX.SYS) when running under a multiterminal monitor. (Also, you can 
run VDT, SDS.SYS, or SDSX.SYS from any terminal in a multiterminal 
configuration.) 


On a multiterminal system, do not abort a job on a private console with 


two CTRL/Cs. Issuing two CTRL/Cs to a job on a private console can 
crash the system. You must abort a job on a private console from the 
hardware console. From the hardware console, first use the SUSPEND 


command to suspend the job on the private console and then use the ABORT 
command to abort that job. 


If you use VDT or the DBG-11 soft I/O version pseudohandlers (SDS.SYS or 
SDSX.SYS) with a multiterminal monitor, you must set your terminal to 
NOWRAP (SET TT NOWRAP) . 


Support of the DL11-W interface requires a REV E or later module. 
Without a REV E module, ECO (Engineering Change Order) number DEC-O-LOG 
M7856-S0002 must be applied to the M7856 module. 


Support of the DLV11-J interface requires a REV E or later module. 
Without such a module, ECO M8043-MRO02 must be applied to the M8043 
module. 


The multiterminal handler can support remote terminals. Modem control 
is available for both DL11-E and DZ11 interfaces. The DL11 control 
answers ring interrupts, letting terminals dial in to the system. 
Dial-in is possible with the DZ11 interface, despite lack of a ring 
interrupt in the DZ11, if the modem is operated in auto-answer mode. 
This is achieved through a polling routine that periodically checks the 
status of each line on the multiplexer (see Chapter 5 of the AT-11 


Software Support Manual). Dial-up support for DZ interfaces requires 
BELL 103A-type modems with "common clear to send and carrier" jumpers 
installed. With this option installed, the modem operates in 


auto-answer mode. 
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@ The hardware console interface must be a DL interface and it must be a 
local terminal. You can use the SET TT: CONSOL command to move the 
background console to any other local terminal in the system. 


@ The number of DL interfaces RT-11 supports, both local and remote, is 
limited to eight. This number includes the hardware console interface. 


@ The number of DZ11 controllers is limited to two, for a total of 16 
lines. The total of DZV11 controllers is limited to four, for the same 
total or 16. 


@e The VT11 scroller option is disabled when the multiterminal special 
feature is present in a system. The commands GT ON and GT OFF are not 
valid in multiterminal systems. For this reason, EDIT cannot use the 
display support. The use of graphics is still supported, though, and 
the display support in TECO works as well. 


@ The maximum input data rate for a single terminal is 300 baud. The 
aggregate total input data rate for a system is 4800 baud. 


You can set the output baud rate to any speed; RI-11 sends output as 
fast as possible, depending on the capacity of the CPU and the nature of 
its load. 


e When you press double CTRL/C in an SJ system, the monitor does a 
hardware RESET instruction. This causes the DZ multiplexer to reset its 
status and to drop Data Terminal Ready on all lines, thus hanging them 
up. This action is part of the general cleanup the system performs 
after a program aborts. 


e If you plan to devote a terminal line to the DD, LS, or XL handler, do 
not specify that terminal’s DL interface in the SYSGEN dialog for a 
multiterminal system. Do not attempt to attach the terminal from a 
multiterminal application program, either. 


@ Setting the baud rate, character length, number of stop bits, and parity 
by way of the .MTSET programmed request 1s supported only for DZ 
interfaces. 


3.2 CURRENT RESTRICTIONS FOR PROFESSIONAL 300 SERIES PROCESSORS ONLY 


When running RT-11 V5.4 on Professional 300 series processors, observe the 
following restrictions: 


e When you use the PRINT SCREEN function on Professional series processors 
and the text displayed on your screen contains certain character sets or 
character and/or line attributes (bolding and so forth), your printer 
might not print the entire screen line. 


You can avoid (or minimize) this problem by setting the LS handler 


condition GRAPH, using the SET LS GRAPH command. You must unload and 
reload the LS handler before any LS condition will change. 
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DIGITAL recommends that multiterminal monitors for Professional 300 
series processors be generated for multiterminal timeout support 
(MTISM=1) . 


Professional 300 series processors only support multiterminal monitors 
that have SYSGEN support for one terminal. Do not attempt to run a 
multiterminal monitor on a PRO that has SYSGEN support for more than one 
terminal. 


Smooth screen scrolling is not supported for Professional series 
processors. Do not issue the command SETUP SMOOTH if using a 
Professional series processor. 


You must UNPROTECT the PI handler (PI.SYS or PIX.SYS) before executing 
the SETUP RETAIN command. 


The terminal console display can be changed when changing from one 
national replacement character (NRC) set to another. 


PRO/GIDIS support is not available under the FB monitor. 


DIGITAL recommends that existing programs being transported to 
Professional 300 series processors be relinked as virtual jobs to be run 
under XM. They should use both virtual overlays and virtual .SETTOP as 
required to minimize low memory use. A useful technique is to create a 
dummy root that calls the real main program linked as virtual overlay 
segment 1. That procedure is usually necessary when attempting to run 
large programs that formerly executed under the SJ or FB monitor. 


If you cannot relink your programs, an alternative technique uses the 
unsupported virtual run utility VBGEXE to create a simulated SJ/FB 
environment that is sufficient to execute many programs without 
relinking. For more information, refer to the RT-11 System Utilities 
Manual. 


Due to possible contention with the memory management unit, split-screen 
scrolling under the FB monitor refreshes the screen on each line scroll. 
DIGITAL recommends using the XM monitor on Professional 300 series 
processors. 


SETUP DATE,TIME should be issued after the first hard boot to set the 
time-of-year clock. Otherwise, subsequent boots will assume the clock 
is valid because the battery will have had time to charge. That command 
is included in the automatic installation procedure by default. 


On Professional series computers, bootstrapping the system causes a 
terminal restart; that is, whenever you bootstrap the system, terminal 
status reverts to the last information saved by SETUP. 


Due to memory limitations, the 132-column mode is not available under 
the FB monitor. 
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PRINT SCREEN can be used only under the XM monitor and only when SPOOL 
is running. 
The SJ and AI monitors are not supported and do not work. 
ASCII 8-bit supplementary code is not supported. 
Professional 300 series and Q-bus processors can read and write the same 
RX50 diskettes. However, a bootable system diskette written for the 


Professional 300 does not boot a Q-bus processor. 


You cannot use ODT (on-line debugging technique) on Professional series 
processors. Use VDT (virtual debugging technique) instead. 


Only one RX50 controller module can be used. No additional RX50 
diskette drives can be added. 


FILEX is not supported. 
The BOOT/FOREIGN command is not supported. 


SETUP NOCLICK does not work after a hard boot when issued from a 
Start-up command file. 


No user input/output (write/read) operation can be addressed to the PI 
(Professional interface) handler; attempts to do so cause a hard error. 
PI must be present on the system disk and loaded at all times. 
RT-11 V5.4 on Professional series processors does not support the 
following VT100 control character codes, modes, character sets, and 
tests, adjustments, and reports: 
Control Character Codes: 

ETX (end of text) 

EOT (end of transmission) 
Modes: 

DECPEX (printer extent mode) 

DECPFF (printer form-feed mode) 

SRM (send-receive mode) 

MC (auto print mode) 

All VTI52 modes 


Character Sets: 


Alternate ROM character set 
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Alternate ROM special character set 
Tests, Adjustments, and Reports: 

All DECTST (device diagnostic tests) 

ECLL (load LED) 


DSR (printer) 


3.3 CORRECTED PROBLEMS 


The following problems in previous versions of RT-11 have been corrected in 
RT-11 V5. Change bars indicate problems corrected after publication of the 
RT-11 V5.3 Release Notes (AA-5286H-TC) and for RT-11 V5.4. 


3.3.1 Automatic Installation 
The following problem in automatic installation has been corrected: 


® If you requested no SYSGEN when running CONFIG.COM, SJFB.ANS remained on 
the configured disk. CONFIG.COM now deletes SJFB.ANS from the 
configured disk if you request no SYSGEN. 


3.3.2 Monitors 
The following monitor problems have been corrected: 


e For RT-11 V5.3, any RT-11 monitor that was generated with memory parity 
support would not boot on machines immediately following a power-up. 
For RT-11 V5.4, monitors that are generated with memory parity support 
boot correctly on power-up. 


@® Previously, after initial start-up (cold boot), a monitor built for 
memory parity support running a program that read locations not 
initialized by the bootstrap could cause a memory parity error trap. 
Now, the bootstrap performs a read/write operation on all locations, 
including those below the 28K-word boundary, during the memory sizing 
operation, which corrects parity for all memory locations. 


@ The system no longer halts when a monitor without memory parity support 
is booted on a KDJ11-A and a cache parity error occurs. 
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KMON - The following problems with the keyboard monitor have been 


corrected: 


Previously, issuing a command to UNLOAD a nonexistent job or device 
handler could crash the system when the monitor was built using certain 
SYSGEN conditions. For RT-11 V5.4D, unloading a nonexistent job or 
device handler does not crash the system under any monitor. 


Previously, KMON incorrectly processed only the first condition in a 
multicondition SET command for the TT handler. KMON ignored any 
conditions following the first and returned no error message. For RT-11 
V5.4C, KMON correctly processes all conditions in a multicondition SET 
command for the TT handler. 


Previously, when running under the SJ monitor, you could not use the 
.CHAIN request to chain to a program when the handler for the device 
containing that program was not loaded. Attempting to do that returned 
the error message, ?MON-F-Trap to 4 nnnnnn, rather than running the 
program. For RT-11 V5.4B, the .CHAIN programmed request works under the 
SJ monitor as documented. 


Previously, issuing a CLOSE command could hang or crash your’ system 
under the following circumstances: a channel was still open to the 
device containing the file you were closing, and that device was not 
loaded. Those circumstances could corrupt the fetched handler for that 
device. For RT-11 V5.4B, the CLOSE command correctly fetches and 
releases the device handler, and the problem does not occur. 7 


Previously, the ABORT command did not correctly stop a job under the XM 
monitor when that job had called and enabled the .SCCA request. ABORT 
set bit 15 in a random word and not the .SCCA terminal status word. For 
RT-11 V5.4B, ABORT correctly sets bit 15 in the .SCCA terminal status 
word and correctly stops a job under those circumstances. 


When KMON processed an indirect command file containing multiple 
indirect command files, KMON saved the command file depth status before 
determining if all nested indirect command files existed. If one of the 
nested indirect command files did not exist, and error was set NONE, 
KMON reported the nonexistent file and then processed the next file 
twice. Now, KMON correctly saves the command file depth status while 
reporting the nonexistent file and then properly restores it. The next 
indirect command file is correctly processed only once. 


Previously, a virtual job could not pass information when chaining to 
another job. Also, you could not chain to a virtual job. Now, a 
virtual job can pass information when chaining to another job, and you 
can chain to a virtual job. 


The keyboard monitor RUN command no longer automatically loads locations 
500-777 of the save image. The Chain Bit (bit 8 of offset 44 in block 
0) must now be set to do that. Programs such as MUBASIC that do not set 
that bit but require that the save image be loaded, must be run using 
the R command. The R command loads those programs properly. 
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CURRENT RESTRICTIONS AND CORRECTED PROBLEMS 


When the EXECUTE command was issued and the device was not resident, 
KMON returned the error message ?KMON-F-File not found FORTRA.SAV. KMON 
now returns the error message ?KMON-F-Handler must be loaded <DEV:>. 


The EXECUTE command when issued for a device and file name, but no file 
type, causes KMON to first search for .FOR, then .MAC, then .DBL file 
extensions. If no filespec is found with those extensions, KMON 
previously returned the error message ?KMON-F-File not found FORTRA.SAV. 
KMON under those circumstances now returns the error message 
?KMON-F-File not found DEV:FILENAM.TYP. 


Previously, nested indirect control files and nested indirect command 
files that contained a CTRL/C could skip the command following the 
CTRL/C. Control could revert to the calling file before the nested file 
finished processing. That could happen to indirect control files nested 
within indirect command files and indirect command files nested within 
indirect control files. Now, nested files correctly finish processing 
under those circumstances. 


Specifying a unit number for SL with the UNLOAD command (UNLOAD SLn) 
incorrectly let you unload SL while it was running, which could crash 
the system. Now, KMON checks if SL is running before executing the 
UNLOAD SLn command and correctly prohibits execution of that command if 
SL LS running, 


Lowercase characters within a command file are no longer converted to 
uppercase if the program receives the command line by issuing a .GTLIN 
request with the lowercase bit set. 


Virtual jobs now correctly initialize synchronous system trap vectors. 


The user stack in KMON containing context switching information was 
being written-over by a background job overlaying KMON, or a background 
job in the process of overlaying KMON was being written-over by the 
context information for a system or foreground job. In either case, the 
background job’s context information or the background job itself was 
corrupted. Now, the user stack points to the transitional stack in RMON 
before doing the read operation that overlays KMON. The background 
job’s context information and the job itself are not corrupted. 


When KMON parsed a file name longer than six characters, KMON printed 
the error message ?KMON-F-Command file not at end of line. In RT-11 V5, 
KMON prints the more appropriate message ?KMON-F-Error in file spec. 


With previous versions of RT-11, the device had to be loaded prior to 
chaining to another file. In RT-11 V5, devices need not be loaded. 


geal 


a a 
routine 


Ee Ey 


CURRENT RESTRICTIONS AND CORRECTED PROBLEMS 


The command DELETE * now expands to the command DELETE *.* rather than 
the command *.NULL. 


When you omitted an argument from an option that required one, a trap to 
4 occurred. In RT-11 V5, when you omit a required argument, the trap to 
4 does not occur and KMON prints the error message ?KMON-F-Invalid value 
specified with option. 


If you performed a chain exit when running under a monitor with system 
job support, vector areas 472-476 were destroyed. Those vector areas 
are now preserved. 


Typing digits in a command name caused KMON to print the error message 
?KMON-F-Ambiguous command. That message is appropriate for commands 
that contain only alphabetic characters. in RI-il Vo, sang digits 
rather than characters in the command generates the error message 
?KMON-F-Invalid command. 


In RT-11 V5, KMON- prints the error message ?KMON-F-Invalid set 
parameter, rather than ?KMON-F-Illegal command, if the handler specified 
in the command rejects parameters. 


MITINT - The following problems with the multiterminal interrupt 
module have been corrected: 


RT-11 rejected (did not answer) incoming calls to the shared console 
that was SET to a remote DL line, unless a program was running that had 
attached to that DL line. RT-11 now accepts (answers) incoming calls 
under those circumstances. 


Generating a multiterminal XM monitor with BATCH support but without 
system job support no longer causes a branch out-of-range condition. 
Previously, this error occurred during the phase of SYSGEN that builds 
the multiterminal interrupt routine module (MTTINT). 


RMON - The following problems with the resident monitor have been 


corrected: 


@ 


The SJ monitor now correctly uses the .EXIT request to reset the .SFPA 
request address, which correctly restores the default FPU (floating 
point unit) trap handling mechanism. 


An SJ monitor that included SYSGEN-option timer support sometimes hung 
in a completion routine during heavy I/0 use. Priorities were not 
correct during execution of the clock routines, and therefore, the 
accumulation of clock ticks began at the wrong value. Now, priorities 
are correctly set, and the accumulation of clock ticks begins at the 
correct value. The SJ monitor no longer hangs during heavy I/O use. 
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The .ABTIO request now aborts only 1/0 queue elements belonging to the 
specified channel of the issuing job. Also, .ABTIO no longer loses any 
of the queue elements that it aborts. 


Programmed requests .FPROT and .SFDAT now work when issued from virtual 
jobs. The resident monitor no longer fails to relocate the address of 
the argument block. 


3.3.2.4 USR - The following problems with the user service routines module have 
been corrected: 


Previously, a handler that was set to be both special directory 
structured and file structured (bits SPECL$ and FILSTS set in the device 
status word) would not gain control when directory operations were 
requested. For RT-11 V5.4D, a handler with this bit combination set in 
its device status word correctly gains control when directory operations 
are requested. 


The .CSISPC programmed request incorrectly closed channels 0, 1, and 2 
when it found an error in a command received from the terminal or an 
indirect file. For RT-11 V5.4, the .CSISPC programmed request correctly 
does not modify any channels. 


When running the IND control processor under all monitors, any .GTLIN 
prompt from a program to the terminal was suppressed. Now, a .GTLIN 
prompt to the terminal from a program running under IND is not 
suppressed. 


Under the SJ monitor, the .GTLIN programmed request did not echo user 
input when TTSCP$ was set. The .GTLIN request now echoes user input 
when TTSCPS is set. 


When an indirect command file contained blank lines for utility version 
numbers, the version numbers were not always displayed. Version numbers 
are now displayed. 


Files created on a device were not always allocated the smallest empty 
space for the file length requested. The smallest empty space for the 
file length requested is now allocated. 


3.3.3 Utilities 


The following problems have been corrected for utility programs. 


3.3.3.1 BATCH - The following problem with the BATCH utility has been 
corrected: 


® Previously, BATCH did not work. Attempting to run BATCH returned the 


error messages, ?MON-F-No device or ?BATCH-F-Invalid LOG device. For 
RT-11 V5.4, BATCH works as documented. 
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3.3.3.2 BINCOM - The following problems with the binary comparison utility have 
been corrected: 


Previously, performing a binary comparison involving a magtape, where a 
file specification included wildcards (* or %), could crash or corrupt 
the system. For RT-11 V5.4C, performing a binary comparison under those 
circumstances works as documented. 


BINCOM could corrupt data in its internal buffers before comparing it 
when the /END:n option was used and the following conditions applied: 


The shorter of two unequal length files being compared was of size 
si. 


The BINCOM internal buffers were a particular multiple of the 
shorter file segment being compared. 


That problem is corrected in RT-11 V5.4. 


When a wildcard binary comparison between files on two devices was 
directed to an output file, using a command such. as 
DIFFERENCES/BINARY/OUTPUT:TEST.DIF dd:*.* dd:*.*, BINCOM wrote the 
output file only when the last two files compared contained differences. 
No output file was written even if files (other than the last two) 
contained differences. Now, BINCOM correctly writes the output file 
when any files on the devices are different. 


When using BINCOM to create a SIPP command file, the flag to strip the 
leading zeros was cleared at an incorrect time, which caused significant 
zeros in addresses higher than 7776 to be lost in the created SIPP 
command file. BINCOM now correctly clears the flag, and the SIPP file 
1s correctly created. 


When comparing two diskettes, a bad block on one diskette was treated as 
end-of-device by BINCOM, which resulted in the other diskette being 
reported as longer. Now, BINCOM distinguishes the EOF mark from a_ bad 
block. The problem is corrected. 


When a comparison was being performed and one or both of the files or 
volumes being compared resided on a diskette, BINCOM generated a hard 
error message if it reached the end of the diskette. in KRi-1ll V5, 
BINCOM returns to the keyboard monitor when BINCOM reaches the end of 
the diskette. 
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3.3.3.3 BUP - The following problems with the backup utility program have been 
corrected: 


Previously, BUP would fail and could crash your system if you attempted 
to restore a file from a device saveset on magtape when that file began 
after block 32,767 on the original disk image. For RT-11 V5.4C, BUP 
correctly restores a file from a device saveset under those 
circumstances. 


Previously, RT-11 did not print any warning message if you restored a 
device image to your system device. Doing that can cause an uncoupling 
of RMON and the system files and could corrupt your system device. For 
RT-11 V5.4B, BUP displays the following warning when you issue the 
command BACKUP/RESTORE/DEVICE and your system device is the output 
volume: 


Restoring over SYSTEM volume! 
SY:/Restore; Are you sure? 


Previously, BUP attempted to back up files containing zero blocks. For 
RT-11 V5.4B, BUP refuses to back up files containing zero blocks and 
returns the following error message: 


?BUP-F-No blocks to backup 


BUP for RT-11 V5.4A corrects several problems with the /VERIFY option, 
when that option is used to verify multivolume magtape backups. BUP for 
RT-11 V5.2 fails in the verify pass at the end of the last volume of a 
multivolume set. BUP for RT-11 V5.3 and V5.4 fails in the verify pass 
at the end of the first volume if another volume is to follow. BUP for 
RT-11 V5.4A correctly verifies multivolume magtape volumes. 


Previously, BUP wrote one extra magtape block when the number of disk 
blocks being read was divisible by eight but not divisible by eight 
times the number of memory buffers. For RT-11 V5.4A, BUP no _ longer 
writes an extra block under those circumstances. 


Previously, BUP displayed the following error message when you attempted 
to back up to amagtape drive that was write protected, not ready, or 
off line: ?BUP-F-Directory input error on ddn:, where ddn: was. the 
input disk drive. For RT-11 V5.4A, BUP returns the following error 
message under those circumstances: ?BUP-F-Output error Mxn:, where Mxn 
is the magtape drive. 


Previously, BUP incorrectly reported an input error on the output disk 
drive when an error was encountered reading back a magtape block during 
a BACKUP/RESTORE/VERIFY operation. For RT-11 V5.4A, BUP correctly 
returns the error message, ?BUP-F-Input error mxn:ddn.BUP, where mxn is 
the magtape drive and ddn.BUP is the name of the restored file image on 
the output drive. 
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Previously, BUP did not append the device and backup set number to the 
error message it returned (?BUP-F-Output error) if an error occurred 
while writing a magtape. For RT-11 V5.4A, BUP correctly appends the 
device and backup set name and returns the error message, ?BUP-F-Output 
error Mxn:ddn.BUP, under those circumstances. 


Previously, BUP could fail to correctly initialize, back up, and restore 
data when the output volume was an RLO1/RLO2 (DL) or RKO6/RKO7 (DM) that 
was initialized with a non-RT-11 format. Results of a backup and 
restore operation using such a volume were unpredictable and often 
incorrect. For RT-11 V5.4, BUP correctly performs backup and restore 
operations for those volumes when they were previously initialized as 
non-RT-11 volumes. 


Previously, BUP could fail to restore a single file from a magtape 
backup volume when file directory segments on the backed-up volume were 
not forward linked. BUP could not correctly search the directory of a 
volume on a magtape backup if that directory contained one or more 
segments that were not forward linked to the other segments. For RT-11 
V5.4, BUP correctly follows the links of the directory segments and 
successfully restores single files under those circumstances. 


Previously, BUP could incorrectly determine the size of an RKO5 disk. 
When backing up a file that was larger than a single RK05 disk, BUP 
would incorrectly inform you to use PIP to copy the file to a single 
RKO5. For RT-11 V5.4, BUP correctly sizes RK05 disks and no longer 
informs you to use PIP under those circumstances. 


Previously, when you attempted to use VBGEXE to run BUP, BUP returned 
the error message, ?BUP-F-Channel in use. For RT-11 V5.4,. you can 
successfully use VBGEXE to run BUP. 


Previously, when a diskette was incorrectly inserted in a drive or a 
magtape was off-line during a backup operation, BUP issued a fatal-level 
error message and aborted the operation. Now, under those 
Circumstances, BUP issues an error-level error message and prompts you 
to mount another volume in the drive. 


When performing file backup operations, V5.2 BUP incorrectly wrote a 
1280 (decimal) -block output file regardless of the input file size. That 
was true only for V5.2 file backup operations. Device backup operations 
under V5.2 performed as documented. For RT-11 V5.3, BUP correctly backs 
up files and devices as documented. See the V5.3 file VSNOTE.TXT for 
complete information. 


A copy operation could corrupt the output file when the number of blocks 
of the file buffer in memory was not a multiple of the output tape 
transfer block size. Now, the file buffer in memory need not be a 
multiple of the tape transfer size for BUP copy operations. 
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BUP (or the BACKUP command) could not be used to back up a disk to 
magtape if the disk contained bad blocks covered with FILE.BAD files. 
Now, that restriction is removed. 


When running under the XM monitor, BUP was restricted to a single output 
volume. Now, backup is no longer restricted to a single volume. 


When backing up an RLO2 to a file-structured TSV0O5, BUP gave an 
incorrect BUP-F-Read error message, although the transfer was completed 
correctly. Now, BUP no longer gives that incorrect error message. 


When backing up to a second RLO2 disk, BUP gave an incorrect error 
message ?BUP-W-Incompatible output volume size. Now, BUP no longer 
gives that incorrect error message. 


When running under the XM monitor, BUP gave an incorrect EOT message 
when backing up to multiple tape volumes. Now, BUP no longer gives that 
incorrect EOT message. 


3.3.3.4 DIR - The following problems with the directory utility have been 
corrected: 


Previously, if you included the /SINCE and /BEFORE options in a _ single 
command line and in that order, DIR always indicated no files within the 
specified range on the device, even when appropriate files existed. For 
RT-11 V5.4C, including the /SINCE and /BEFORE options in any order in a 
Single command line works as documented. 


When you omitted a portion of the date in the DIRECTORY/SINCE[:date] 
command, DIR did not correctly append values from the current system 
date. DIR now correctly appends current system date values for any you 
omit in that command. 


DIR no longer prints the incorrect ?MON-F- output error message prefix 
but instead prints the correct ?DIR-F- prefix, when the output device is 
write locked. 


3.3.3.5 DUMP - The following problems with the DUMP utility have been 
corrected: 


@ Previously, if you assigned the DUMP default output device (LP) to a 


file-structured device (for example, ASSIGN DU1 LP), DUMP did not 
recognize the assigned device as the default output device and returned 
the error message, ?DUMP-F-No LP, when you attempted to run DUMP. For 
RT-11 V5.4, DUMP recognizes the assigned device as the default output 
device and does not return the error message under those circumstances. 
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Previously, if you used the CSI form to run DUMP and specified an output 
device (other than TT:) without a file name, the command failed and 
returned the error message, ?CSI-F-Invalid command. For RT-11 V5.4, the 
command works as documented and places the output on the device you 
specify with the default file name DUMP.DMP. 


The DUMP/ONLY:n DMO: command previously caused the error message, 
?DUMP-F-Invalid option /E, to be displayed, when the desired block 
number was less than 32768(decimal). The DUMP/ONLY:n DMO: command now 
works properly regardless of the block number. 


When a diskette was being dumped, DUMP generated a hard error message 
when DUMP reached the end of the diskette. In RT-11 V5, DUMP returns to 
the keyboard monitor when DUMP reaches the end of the diskette. 


3.3.3.6 DUP - The following problems with the device utility program have been 
corrected: 


Previously, DUP incorrectly initialized magtapes by writing random 
characters to the ANSI VOL1 label record. FOr -BRi=il Wo,48; DUP 
correctly initializes magtapes by writing blanks (ASCII space 
characters) in character positions 52 through 79 of the ANSI VOL1 label 
record, which conforms to ANSI standard X3.27-1978. 


For RT-11 V5.3, DUP would only soft boot processors that contained the 
KT11 memory management unit. For RT-11 V5.4, DUP does not require the 
KT11 memory management unit to perform a soft boot. 


DUP did not append a wildcard file specification (*.*) to a CSI command 
if you omitted it in a CSI command line that contained the /F and /I 
options (dd:file.ext/F=dd:/I). Therefore, DUP returned the error 
message ?DUP-F-Invalid command. Now, DUP appends the wildcard file 
specification if you omit it in a CSI command line that contains the 
/F/I options. 


If you wanted to create a file, using the CREATE/ALLO:nnn command, and 
there was insufficient space to create the file, the DUP utility 
displayed the error message ?DUP-F-Conflicting SYSGEN options. DUP now 
displays the error message ?DUP-F-No room for file. 


DUP no longer traps to 4 (odd address/bus timeout trap vector) when you 
initialize a volume with bad data in the extra bytes field of the 
directory header. 


Using the /DEVICE/FILE/WAIT options combination (DUP/I/F/W) in a COPY 


command 1s now supported, and DUP no longer returns an error message 
?DUP-F-Invalid command. 
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> @ The BOOT/FOREIGN (DUP/Q) command occasionally did not work, because DUP 
| did not properly simulate a hardware bootstrap. DUP now properly 
Simulates hardware bootstraps for all supported devices. 


@® The CREATE/ALLOCATE:-1 (filespec[-1]=/C) command incorrectly entered a 
file size of 65535 blocks in a device directory regardless of the actual 
amount of available space. CREATE/ALLOCATE:-1 now correctly enters the 
maximum space available in the device directory. 


@ When several DUP options were specified with the /WAIT (DUP /W) option, 
DUP prompted to mount the input volume once for each operation 
requested. In RT-11 V5, the prompt to mount a volume is printed only 
once. 


@® When using the command INIT/BAD/WAIT ddn: (DUP/B/W), where ddn is the 
device in which the system disk resides, DUP did not prompt to mount the 
input volume a second time for the initialization operation. Therefore, 

aa DUP initialized the system volume instead, destroying the boot blocks. 
| ) DUP now correctly prompts you to mount the input volume. 


@ When using the BOOT/WAIT command, DUP printed the prompt 
?DUP-W-Foreground loaded. Are you sure? twice. In RT-11 V5.1, the 
prompt is printed only once. 


3.3.3.7 Error Logger - The following problem with the error logging utility has 
oo been corrected: 


@® Previously, attempting to run ELINIT twice returned the fatal level 
error message, ?ERRLOG-F-Invalid message received. For RT-11 V5.4C, 
running ELINIT more than once returns the warning, ?ERRLOG-W-Invalid 
message received. 


@e The error logger did not report the correct time of error. The time of 
error 1S now reported correctly. 


H \ 
3.3.3.8 FORMAT - The following problems with the formatting utility have been 
corrected: 

@ Previously, formatting with verification (FORMAT/VERIFY) an RX33 
diskette with the DU handler not loaded produced a fatal monitor error 
after the formatting completed. For RT-11 V5.4D, such a _ format 
operation works as documented and produces no fatal monitor error. 

3.3.3.9 HELP - The following problems with the on-line HELP utility have been 
corrected: 

@® The HELP/PRINT topic command no longer causes the system to hang. 
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@® Previously, the command HELP ? returned an incorrect error message. 


Now, that command returns the error message ?HELP-F-HELP not available 
DOn! ts 


3.3.3.10 IND - The following problems with the indirect control file processor 
have been corrected: 


Previously, the .TEST directive failed to detect nonalphanumeric 
characters appearing in a string symbol after the first occurrence of a 
lowercase alphabetic character. For example, performing a .TEST SYMBOL 
where SYMBOL contained the string "v/" would incorrectly set the special 
symbol <ALPHAN> to TRUE. For RI-11 V5.4B, the .TEST directive 
recognizes nonalphanumeric characters appearing in a string symbol after 
a lowercase alphabetic character, and <ALPHAN> would be correctly set to 
FALSE for this example. 


Previously, the .TESTDEVICE directive incorrectly returned off-line 
(OFL) status for a DM device that was logically possible but physically 
nonexistent. By default, the DM handler contains valid table entries 


for eight devices. If a configuration contained less than eight DM 
devices, a .TESTDEVICE directive to a nonexistent DM device incorrectly 
returned OFL status rather than the correct NSD (No Such Device). For 


RT-11 V5.4B, the .TESTDEVICE directive correctly returns the NSD status 
for logically possible but physically nonexistent DM devices. 


For RT-11 V5.3, the .TESTDEVICE directive sometimes returned incorrect 
mounted (MTD) and unmounted (NMT) status information for logical disks. 
IND did not correctly track the new data table information in the 
LD (xX) SYS tile, For KRi=ll V5.4, IND correctly tracke the LD(x),SYS file 
data tables, and the logical disk mount information returned by the 
sTESTDEVICE directive is correct. 


Previously, the .TESTDEVICE directive incorrectly returned off-line 
(OFL) status for a DL device that was logically possible but physically 
nonexistent. By default, the DL handler contains valid table entries 
for two DL devices. If a configuration using the distributed DL handler 
included only one DL device (DLO), a .TESTDEVICE to the nonexistent DL1l 
device incorrectly returned OFL status, rather than the correct NSD (no 
such device). For RT-11 V5.4, the .TESTDEVICE directive correctly 
returns the NSD status for logically possible but nonexistent DL 
devices. 


Previously, the .TESTDEVICE directive incorrectly returned the LOD 
(loaded) status for magtape handlers that were in fact not loaded. 
Other status information returned on unloaded magtape handlers was also 
randomly incorrect. For RI-ll V3.4, the .TESTDEVICE returns correct 
status information on unloaded magtape handlers. 


Previously, the .TESTDEVICE directive could incorrectly return size and 


status information for some DU devices. That problem is corrected for 
Romi Voua. 
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Previously, IND did not interpret some errors returned by PIP and DUP. 
Therefore, IND did not correctly process all PIP and DUP errors. For 
RT-11 V5.4, that error information 1s now mapped to IND’s internal error 
table, and IND processes PIP and DUP errors correctly. 


Previously, when the .TESTDEVICE or .VOL directive encountered some 
device read-related errors, IND would exit with a fatal error condition. 
That problem happened even if you included the .ONERR directive in your 
code, because the .ONERR directive attempted to access the <FILERR> 
special symbol and .TESTDEVICE and .VOL did not support <FILERR>. Now, 
the .TESTDEVICE and .VOL directives support the <FILERR> special symbol. 
You can perform error recovery in your code that prevents IND from 
exiting due to read-related error conditions. 


The .TESTDEVICE directive incorrectly reported the status of the SPOOL 
device handler SP as OFL (off line). .TESTDEVICE now correctly reports 
the status as UNK (unknown). 


The .TESTDEVICE directive incorrectly reported the status of all logical 
disks as OFL (off line), whether a logical disk was mounted or not. 
That problem was caused by a change made to the LD assignment table 
format for RT-11 V5.3 that was not recognized by .TESTDEVICE. For RTI-11l 
V5.4, .TESTDEVICE correctly reports the status of logical disks. 


IND trapped to 4 when the .TEST directive was used on a valid string 
symbol. That problem occurred because of invalid pointers during the 
.TEST directive processing. Now, the .TEST directive no longer traps to 
4 when it is used with a valid string symbol. 


IND aborted with a fatal error when a read error occurred while the 
.STRUCTURE directive was determining a device file structure. Now, the 
.STRUCTURE directive is modified to return an /’UNKNOWN’ (code (Q) 
structure if a read error occurs. DIGITAL continues to recommend that 
you issue the .TESTDEVICE directive before the .STRUCTURE directive to 
make sure a device is on line and mounted. 


Executing a control file, using the DCL keyboard command syntax RUN IND 
ctrl-filespec[/options] or IND ctrl-filespec[/options] did not let you 
pass parameters. Those commands now let you pass parameters. 


IND now correctly handles symbol names of more than six characters. 
However, IND continues to recognize only the first six characters. 


IND contained a restriction that blank and tab characters could not be 
placed between operators and numeric symbols. IND no longer contains 
that restriction, so numeric expressions can be formatted for better 
readability. 
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»p The .TESTDEVICE directive no longer returns an incorrect device size in 
<EXSTRI> when reporting the status of a device having one size. 


e Previously, the .TESTDEVICE directive returned the error messages, 
?IND-F-Device error, and ?IND-F-Device read error, if you used the KMON 
command LOAD ddx:=F or LOAD ddx:=job to attach to a foreground or system 
job. Now the .TESTDEVICE directive includes ATT or NAT (attached or not 
attached) in field nine of special symbol <EXSTRI>, and the two error 
messages are not displayed. 


@ Previously, a problem occurred with using the .VOL directive if it was 
issued for a device assigned to the foreground or a system job, using 
the LOAD ddn:=F or LOAD ddn:=job commands. That operation returned the 
error message, ?IND-F-Data file error, Invalid device or unit. Now, the 
.VOL directive returns the error message ?IND-F-Invalid device or unit, 
device is attached. That error can be intercepted using the .ONERR 
directive, and you should use the .TESTDEVICE directive to determine if 
the device is indeed attached and to what job. 


3.3.3.11 K52 - The following problems with the K52 keypad editor have been 
corrected: 


@ Previously, when you deleted a character while a VT62 terminal was in 
command mode, any subsequent characters you typed were not displayed in 
reverse video. For RT-11 V5.4D, deleting characters in command mode 
does not affect the video rendition on VT62 terminals. 


® Previously, when you first opened a file, K52 incorrectly interpreted 
any keypad command you issued while the terminal screen was initially 
painting text. For RT-11 V5.4D, K52 correctly interprets keypad 
commands while the screen is initially being painted. 


3.3.3.12 KED - The following problems with the keypad editor have been 
corrected: 


@® Previously, KED could incorrectly return the prompt, ?KED-W-File not 
found - Create it (Y/N)?, when there was no volume in the specified 
drive. For RT-11 V5.4C, KED returns the error message, ?KED-F-Unable to 
open input file. 


@ The FIND command now works for most control characters except “*B, “C, 
ESCAPE, “F, and *X. 


® The LOCAL command now works when applied to a range containing a 
form-feed (<FF>) character. 


@ KED displayed an I/O error message when it reached the end of an 
inspected disk. KED now displays the end-of-file symbol. 
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The KED chain interface now works properly. 


3.3.3.13 LD - The following problem with the logical disk subsetting utility 
has been corrected: 


@® For RT-11 V5.3, the LD handlers LD.SYS (appropriate for the SJ and FB 


monitors) and LDM.SYS (for RTEM-11) would crash the system if a MOUNT 
command was issued after the LD handler was loaded. The LD handler for 
the XM monitor (LDX.SYS) did not exhibit this problem. For RT-11 V5.4, 
the LD handler no longer crashes the system if a logical disk is mounted 
after LD is loaded. 


3.3.3.14 LIBR - The following problems with the librarian utility have been 
corrected: 


f \ 
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Previously, fatal level error messages generated by the LIBRARY command 
occasionally returned the LIBR utility CSI prompt (*), rather than 
correctly returning control to the keyboard monitor. For RT-11 V5.4D, 
that problem is corrected. 


When you incorrectly coupled the /UPDATE option with the output file 
name, the error message returned by LIBR incorrectly included the input 
file name in the error message. Now, LIBR correctly includes the output 
file name in the error message. 


Under certain circumstances, LIBR generated macro libraries where the 
last entry would not appear in the library directory. That problem 
normally occurred when adding to SYSMAC or HELP, and no LIBR error 
message was displayed. Now, all entries into macro libraries appear in 
the library directory. 


The LIBR utility failed if a forms library directory exceeded one block. 
LIBR now allows forms library directories to exceed one block. 


3.3.3.15 LINK - The following problems with the linker have been corrected: 


Previously, LINK did not give the correct value of zero to undefined 
symbols specified by the .WEAK directive in overlaid files. For RT-11 
V5.4A, LINK correctly gives a value of zero to undefined symbols under 
those circumstances. 


Previously, if you directed the binary output file to the NL device ina 
LINK command line, LINK failed and returned the error message, 
?LINK-F-Storing text beyond high limit. LINK did not recognize that you 
were directing the output to the null (NL) device and failed, producing 
that message indicating a read/write error. For RT-11 V5.4, LINK does 
not fail when you direct binary file output to the NL device in a LINK 
command line. 
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Previously, when link maps contained more than one page of undefined 
global symbols, the header information was incomplete on the second and 
following pages. For RT-11 V5.4, the link maps contain complete header 
information on all pages. 


RT-11 V5.3 removes the restriction stating that the total combined size 
of all virtual overlay segments created by the LINK /V option cannot 
exceed 96K-words. Now, the total combined size cannot exceed 
2016K-words. 


Previously, when you linked programs, using the /DUPLICATE option, LINK 
occasionally returned the error message, ?LINK-F-Invalid RLD symbol in 
DEV: FILNAM.OBJ, and prematurely aborted. For RT-11 V5.4, that problem 
is corrected. 


Previously, when you linked overlaid programs, using the /INCLUDE 
option, LINK occasionally returned the error message, ?LINK-F-Internal 
error, and prematurely aborted. For RT-11 V5.4, that problem is 
corrected. 


The /DUPLICATE option incorrectly repeated absolute symbols in the link 
map for each duplication of a library module containing the absolute 
symbol. Now, only the defined global symbols are entered in the link 
map. 


In some cases when you used the /U option, LINK displayed the error 
message ?LINK-F-Address space exceeded, even though the program’s high 
limit was less than 32K words. That problem was caused by the improper 
initialization of a variable and has been corrected. 


In some cases when you linked valid object modules, LINK displayed the 
error message ?LINK-F-Invalid GSD in DEV:FILNAM.TYP. That problem was 
caused by code that processes transfer address entries in the global 
symbol directory (GSD) and has been corrected. 


When absolute binary (.LDA) files were linked with ODT or VDT, the load 
address of the .LDA file was placed such that it was written over and 
corrupted by the ODT or VDT module declaration macro, which produced an 
incorrect link map. Absolute binary files now link with ODT or VDT at 
the correct load address (above ODT or VDT) and produce an accurate link 
map. When preparing Software Performance Reports (SPRs), include the 
version information from ODT/VDT that is found in the link map as .AUDIT 
and .ODT or .VDT symbol values. 


3.3.3.16 PIP - The following problems with the peripheral interchange program 
have been corrected: 


Previously, PIP could incorrectly return the error message, 
?PIP-F-Device in use, when attempting to write a file to a magtape that 
was full. For RT-11 V5.4C, PIP correctly returns the error message, 
?PIP-F-Device full, under those circumstances. 
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Previously, if PIP was writing the first file to a magtape and that 
magtape’s controller lost position, PIP searched back on that magtape to 
find a tape mark. Some magtape controllers return only a BOT and not a 
tape mark. Therefore, PIP could get into an infinite loop searching for 
the nonexistent tape mark. For RT-11 V5.4C, PIP checks for both BOT and 
a tape mark on magtapes when the magtape controller loses position while 
PIP is writing the first file to that magtape. 


Previously, PIP and the FSM (magtape file structure module) could 
incorrectly handle a position-lost write error returned by a magtape 
handler. The interaction between PIP and the FSM could backspace the 
magtape to the wrong position and incorrectly preserve a partial section 
of the bad file, leaving the magtape in an indeterminate state. For 
RT-11 V5.4C, PIP and the FSM properly interact and perform the 
backspacing. The bad file is correctly not preserved, and the magtape 
is left in a valid state. 


Previously, uSing any wildcard in the input file name with the 
COPY/PROTECT command caused the monitor to trap to 4. For RT-11 V5.4B,. 
the COPY/PROTECT command works as documented. 


Previously, the FB monitor failed to perform copy operations from one 
nonfile-structured device to another nonfile-structured device. The 
specific case of copy operations from TT to TT also failed under the SJ 
and XM monitors. For RTI-11 V5.4B, copy operations from one 
nonfile-structured device to another work as documented. 


Previously, characters copied from your terminal (TT:) to an _ output 
device (such as LP:) were always copied in uppercase. For RT-11 V5.4, 
characters are copied from your terminal with no change in case. 


Previously, if the command DELETE/QUERY filnam.SYS was included in an 
indirect command file, responding N (no) to the prompt returned by that 
command incorrectly returned the message ?PIP-W-Reboot. However, the 
specified file was correctly not deleted. For RT-11 V5.4, PIP does not 
return that message under those circumstances. 


When a hard error occurred on a magtape, such as an attempt to copy to a 
write-protected magtape, PIP incorrectly trapped to 4 or 10. Now, PIP 
correctly returns an error message indicating a hard error condition. 


The COPY/SETDATE command, when the input and output filespecs were the 
same, incorrectly moved the specified input file while changing the file 
date. That is, the command actually performed a COPY operation. For 
RT-11 V5.4, the COPY/SETDATE command only changes the file date when the 
input and output filespecs are the same and does not perform a COPY 
operation. 


CURRENT RESTRICTIONS AND CORRECTED PROBLEMS 


® PIP incorrectly treated printers (LP) as sequential access devices for 
COPY operations from the terminal (TT). Therefore, a COPY command from | 
TT to LP produced an invalid device error. Now, PIP correctly copies wy 
from the terminal to the printer. 


e When the system device (SY) and the data device (DK) were assigned to 
the same device, a COPY operation from SY to DK incorrectly performed 
the COPY operation twice. Now, PIP renames the file to the output file 
name rather than copying it. 


@ The COPY/ALLOCATE:size command created a file with the current date 
rather than the input file date. Now, that command correctly uses the 
input file date as the creation date for the output file. 


@ When the COPY/MULTIVOLUME/NOREPLACE (PIP /E and DUP /R) command was 
issued, PIP processed the first output volume correctly. However, when 
the second output volume was mounted, PIP copied the next file from the 
input volume to the second output volume regardless of whether the file 
already existed on that output volume. PIP was not reading the | 
directory of the second output volume before beginning the COPY WY 
operation. PIP now reads the directory of each volume immediately after 
it is mounted, and the /MULTIVOLUME/NOREPLACE options work correctly. 


@ When COPY/PREDELETE (PIP /O) was performed and the specified input and 
output volumes were the same, PIP deleted the file. In RT-11 V5, 
COPY/PREDELETE performs a RENAME operation when the input and output 
volumes are the same. 


@ When wildcards were used in a RENAME/NOREPLACE (PIP /N) operation, the | | 
first file was found but not renamed, and an error message appeared. YY 
RENAME/NOREPLACE now works as documented in the RY-11 System User’s 
Guide and RT-11 System Utilities Manual. 


@ When the /WAIT option (PIP /E) was specified, PIP attempted to read the 
output volume’s directory before it prompted to mount the output volume. 
Therefore, an error occurred (if no volume was present in the output 
device) or the wrong volume could be read. PIP now prompts you to mount 
the output volume before attempting to read its directory. 


3.3.3.17 PRO/GIDIS - The following problem with the GIDIS graphics utility on 
the PRO has been corrected: 


® Previously, when you exited from PRO/GIDIS you did not regain the 


Cursor. You needed to reboot your system to regain the cursor. For 
RT-11 V5.4B, you regain the cursor when you exit from PRO/GIDIS. 
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3.3.3.18 QUEUE - The following problems with the QUEUE utility package have 
f \ been corrected: 


® QUEUE no longer appends a carriage return to the end of files that are 
queued to VM. 


® QUEMAN displayed an error message when you issued the 2-slash (//) line 
terminator option on a line by itself. QUEMAN now accepts the 2-slash 
line terminator option on a line by itself. 


@ QUEUE did not recognize and correctly print asterisk (*) and percent (%) 
characters used in job names on banner pages. QUEUE now correctly 
handles asterisk and percent characters for banner pages. 


3.3.3.19 RESORC - The following problems with the RESORC utility have been 
= corrected: 
f ; 
@e For RT-11 V5.4, the SHOW CONFIGURATION command no longer displays 
"Global .SCCA flag is disabled’ when .SCCA support was not requested 
during SYSGEN. 


@ Previously, when global SCCA was enabled, a portion of the SHOW CONFIG 
data was displayed twice. That problem has been corrected. 


@® The SHOW DEV:DU command now displays the DU UNIT, PARTITION, and PORT 
yp oN translation table as shown in the RT-11 System Utilities Manual. See 
| | also Section 2.28. 


@e When more than 14 logical names were assigned to a device, the SHOW 
command (RESORC) printed a corrupted listing. More than 17 logical name 
assignments to a single device caused RESORC to hang the system. RESORC 
now correctly prints listings, and more than 17 logical device name 
assignments to a single device no longer hang the system. 


@ RESORC now correctly displays the PRO ROM ID. 
ren 


Ssdeoue) “SETUP = The following problems with the hardware characteristics SETUP 
utility have been corrected: 


@ Previously, the SETUP GENERIC command returned an error message if you 
were uSing a PDP-11 processor with a VI200 series terminal. For RT-11 
v5.4, the SETUP GENERIC command works as documented with VTI200 series 
terminals. 


® For RT-11 V5.3, the SETUP SMOOTH command did not work on PDP-11 
processors as documented. For RT-11 V5.4, SETUP SMOOTH does work as 
documented on PDP-11 processors. SETUP SMOOTH is not supported on 
Professional 300 series processors. 
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@ SETUP NOCOMPOSE now works as documented in the RT-1l1 System User’s 
Guide. 


@ The SETUP CAPS and SETUP SHIFT commands now set the appropriate bits in 
the internal table kept in PI. After those commands are issued, SETUP 
SHOW correctly indicates the commands. 


3.3.3.21 SL - The following problems with the single-line command editor have 
been corrected: 


@e SL is now supported with virtual jobs. 


@® Previously, SL did not disable address checking under certain 
circumstances, which could cause the MACRO-11 assembler, when run under 
the CSI command format, to abort with the error ?MON-F-Inv addr. For 
RT-11 V5.4C, SL correctly disables address checking and no longer can 
cause the MACRO-11 assembler to abort. 


3.3.3.22 SIPP - The following problems with the source image patch utility have 
been corrected: 


@® Previously, if you used the /L option and the device was write locked, 
SIPP incorrectly returned the error message ?MON-F-Dir IO error 
<address>. For RT-11 V5.4, SIPP works as documented and does not return 
that error message under those circumstances. 


® Previously, if you used CCL command mode to run SIPP and included the 
checksum option (/C), the checksum prompt was not returned and SIPP 
saved none of the modifications. For RT-11 V5.4, when you use CCL to 
run SIPP and include the checksum option, the command works as 
documented. 


3.3.3.23 SPOOL - The following problem with the spooler utility package has 
been corrected: 


e If a SETUP PRINTER command was issued while SPOOL was running, the 
system would hang or trap to 4. Now, issuing the SETUP PRINTER command 
while SPOOL is running does not hang or trap the system. 


3.3.3.24 SRCCOM - The following problems with the ASCII file comparison utility 
have been corrected: 


@® Previously, performing an ASCII text comparison involving a magtape, 
where a file specification included wildcards (* or %), could crash or 
corrupt the system. For RT-11 V5.4C, performing an ASCII text 
comparison under those circumstances works as documented. 
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Previously, the DIFFERENCES command with the /OUTPUT:filespec option 
could produce a corrupted output file when wildcards were used for input 
file names. For RT-11 V5.4A, a corrupted output file is not produced 
under those circumstances. 


When the DIFFERENCES /CHANGEBAR (SRCCOM /D) option was specified with 
the console as the output device, the message ?SRCCOM-I-No differences 
found, would overwrite the end of the console output. That message is 
now printed on a new line. 


3.3.3.25 SYSGEN - The following problem with the system generation program has 
been corrected: 


ee ne eels 


(TRANSF. 


Previously, SYSGEN generated incorrect symbol names (system 
conditionals) for the second, third, and fourth CSR and VECTORs for 
TMSCP magtape units. For RT-11 V5.4B, SYSGEN generates correct symbol 
names as documented in Section 2.37.3. 


TRANSF - The following problems with the binary transfer utility 
SAV) have been corrected: 


TRANSF now forces the terminal to NOCRLF when you run RT-11 under a 
nonmultiterminal monitor. 


If you type a CTRL/O during a file transfer, the CSI prompt character is 
now displayed when the transfer is completed. 


3.3.3.27 UCL - The following problems with the user command linkage utility has 
been corrected: 


Previously, UCL did not consider a command containing an asterisk 
(minimum abbreviation character) as a valid replacement for the same 
command that did not contain the asterisk. UCL did not clear the 
replaced command. For RT-11 V5.4, UCL clears the replaced command under 
those circumstances. 


The UCL data file (UCL.DAT) was occasionally corrupted before the 
maximum number of commands was entered. The corruption occurred because 
the data file held only 256(decimal) characters for the command 
definition -field, and that number was exceeded before the maximum number 
of commands was entered. Now, a customization patch lets you change the 
size of the UCL data file to any maximum size you specify. 
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VICOM - The following problems with the virtual terminal 


communications utility have been corrected: 


Previously, VICOM would hang when it received an XOFF from the host, and 
you then sent an XON (CTRL/Q) to the host from the VICOM command prompt. 
You could not abort VICOM and would need to reboot your system. Now, 
VTCOM does not hang under those circumstances. 


The EXIT and PAUSE commands now close any open logging file before 
exiting to the monitor. 


3.3.4 Device Handlers 


The following device handler problems have been corrected. 
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3.3.4.3 


CT - The following problem with the CT handler has been corrected: 


Previously, the CT handler would install on all processors under all 
monitors whether or not a TU60 cassette device was in fact in the 
configuration. For RT-11 V5.4, the CT handler only installs if the 
reguired hardware is present at the correct CSR. 


DD - The following problem with the DD handler has been corrected: 


Previously, when running under the XM monitor, an attempt to access 
files on a TU58 DECtape II without loading the DD handler could crash 
the system. For RT-11 V5.4, such an attempt returns the error message, 
?MON-F-Unloaded driver <address>, and does not crash the system. 


DL - The following problems with the DL handler have been corrected: 


Previously, the DL handler did not check .READx/.WRITx requests from a 
nonfile-structured .LOOKUP to determine if they correctly accessed 
replaced blocks only through the bad-block replacement table. For RT-11l 
v5.4, the DL handler rejects any attempt to access replaced blocks other 
than through the bad-block replacement table and returns the carry bit 
set. Special function (.SPFUN) reads and writes continue to directly 
access any block on the device. 


Previously, when you issued the COPY/DEVICE/RETAIN command to the DL 
handler, DL incorrectly read two blocks beyond the data area on the 
input volume. DL then wrote those two blocks to the first two replaced 
blocks on the output volume, thereby corrupting those first two blocks. 
For RT-11 V5.4, the DL handler only reads from and writes to the data 
area when you use the COPY/DEVICE/RETAIN command. 
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Previously, some invalid SPFUN codes directed to DL could cause a 
default action to occur. For RT-11 V5.4, all invalid SPFUN codes 
directed to DL are correctly ignored. 


The DL handler no longer occasionally causes a system crash when used 
under a monitor with error logging support on a system with an RLV12 
controller. 


When a disk reported certain hard errors to the DL handler, the handler 
would reverse seek one track and then reseek to the desired track. The 
DL handler now homes to track 0 and then reseeks to the desired track, 
which improves the chance for recovery from the hard error. 


DM - The following problems with the DM handler have been corrected: 


Previously, the DM handler did not check .READx/.WRITx requests from a 
nonfile-structured .LOOKUP to determine if they correctly accessed 
replaced blocks only through the bad-block replacement table. For RT-11 
v5.4, the DM handler rejects any attempt to access replaced blocks other 
than through the bad-block replacement table and returns the carry bit 
set. Special function (.SPFUN) reads and writes continue to directly 
access any block on the device. 


Previously, when you issued the COPY/DEVICE/RETAIN command to the DM 
handler, DM incorrectly read two blocks beyond the data area on the 
input volume. DM then wrote those two blocks to the first two replaced 
blocks on the output volume, thereby corrupting those first two blocks. 
For RT-11 V5.4, DM only reads from and writes to the data area when you 
use the COPY/DEVICE/RETAIN command. 


Previously, some invalid SPFUN codes directed to DM could cause an 
indeterminate action to occur. For RT-11 V5.4, all invalid SPFUN codes 
directed to DM are correctly ignored. 


DU - The following problems with the DU handler have been corrected: 


Previously, an I/O request with a zero word count (a seek operation) 
directed to some MSCP controllers could cause the system to crash or 
corrupt data. For RT-11 V5.4D, seek operations to all MSCP controllers 
function properly. 


If the system crashes while the DU handler (DUX.SYS) is performing 
bad-block replacement on a disk, restarting the system and accessing 
that disk should cause the DU handler to recover bad-block replacement 
information and complete the bad-block replacement. Previously, that 
process did not work correctly. For RT-11 V5.4A, that process works 
correctly. 
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Previously, if a bad block occurred during a special MSCP BYPASS 
recovery operation (.SPFUN 360 with blk argument set to 1) and the DU 
handler was responsible for bad-block replacement, bad-block replacement 
did not occur. DU attempted to replace a different block that might or 
might not be bad. That attempt was not always successful and could 
crash the system. For RT-11 V5.4A, DU correctly replaces bad blocks 
during a special MSCP BYPASS function. | 


For RT-11 V5.4, the command SET DU SUCCES works as documented. 


For RT-11 v5.4, you can issue the command SET DUx PORT=0 when you have a 
single port DU configuration. That command no longer returns an error 
message in a single port configuration. 


Previously, SPFUN 372 could only read the handler translation table. 
Now, SPFUN 372 writes and reads the table. 


The DU handler installation procedure did not check for port validity 
when installing a-DU device unit that was SYSGENed for multiple ports. 
Attempting to access a DU device unit that was mapped to an invalid port 
crashed the system. Now, that procedure returns an error message and 
does not crash the system. Use the SHOW DEV:DUn command to determine if 
the port mapped to a DU device unit is valid. An invalid port is 
indicated by an asterisk (*) displayed before the port number. 


DU did not correctly check and truncate nonfile-structured .WRITE 
requests that crossed partition boundaries, which could cause data that 
was written across a partition to corrupt data already written in the 
next partition. DU now correctly checks and truncates requests that 
cross a partition boundary. The amount of data actually transferred is 
not reported to the program requesting 1/0, but a hard error is 
indicated. 


After you boot an SBC-11/21 PLUS processor, the SHOW DEVICE command 
displays the standard DU CSR (172150), not the DU CSR (176150) used by 
the SBC-11/21 PLUS. If your CSR address is 176150, DIGITAL recommends 
you use the SET DU CSR=176150 command after booting your system for the 
first time. That command enables RESORC to display the correct CSR when 
you issue the SHOW DEVICE command. 


Volume sizing code reported incorrect information when sizing a 
nonexistent MSCP unit number. Incorrect information was also returned 
on some subsequent size requests. The DU handler now returns correct 
Sizing information under those circumstances. 


Errors produced an excessive number of retries because the retry count 
was incorrectly initialized. The retry count now initializes correctly. 
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SPFUN 360 and 371 (special function bypass) were restricted in use only 
to privileged jobs because the response and command buffer was required 
to be in the low 28K words of memory. The response and command buffer 
is no longer required to be in the low 28K words of memory; that 
restriction is removed. 


DZ - The following problem with the DZ handler has been corrected: 


Previously, the DZ handler wrapped unit numbers such that an operation 
directed to DZ4 would wrap to DZ0, DZ5 would wrap to DZ1, and so on. 
For RT-11 V5.4B, the DZ handler no longer wraps unit numbers. 


DW - The following problems with the DW handler have been corrected: 


Previously, you could specify unit (n) numbers 0 and 1in the SET DWn 
[NO]WRITE command. Now, you can only specify unit number 0. An omitted 
unit number defaults to unit 0. 


Previously, the DW handler applied the wrong mapping of logical block 
numbers to physical block numbers on RD5x hard disks. The correct 
mapping is used in RT-11 V5.3. See the DW section in Chapter 2 for 
information. See the ISPFN and .SPFUN sections in Chapter 2 for changes 
to the blk argument caused by the DW remapping. 


DY - The following problem with the DY handler has been corrected: 
An overflow of the SET table area of the RX02 handler occurred if the 


handler was built to include second controller and error logger support. 
The overflow no longer occurs. 


LD - The following problems with the LD handler have been corrected: 


Previously, start-up command files aborted if they attempted to access a 
logical disk that was mounted on a noninstalled device. LD returned the 


fatal error severity message ?LD-F-Device not installed DEV:. Now, the 
severity of the error message returned by LD under those circumstances 
is reduced to a warning ?LD-W-Device not installed DEV:. You receive 


the warning message and the start-up command file no longer aborts. 


Previously, you could not customize the LD handler name suffix; you had 
to use a suffix of X or M. Now, you can customize the LD handler suffix 
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character. You must perform customization D.3, Changing the Handler 
File-Name Suffix, located in the R7T-11 System Generation Guide. You 
must also perform the customization described in Section 2.5.9.2 to make 
that suffix character known to the monitor bootstrap. 


Previously, a fetch error occurring during an operation requiring LD to 
fetch a handler could corrupt LD’s internal table. Now, a fetch error 
occurring under those circumstances correctly returns the error message 
?LD-F-Fetch error. 


Previously, the error message ?LD-F-No file specified <DEV:> printed 
extraneous characters. It no longer does that. 


Monitors built with nonstandard suffixes caused the SET LD CLEAN and 
SHOW SUBSET commands to not work properly. Those commands now work 
properly with monitors built with nonstandard suffixes. 


Error messages that contain an option or an option with a value are no 
longer corrupted. 


LD no longer does an odd address reference (trap to 4) when it 
encounters an unknown option letter. 


LDX and LDM no longer print a corrupted version number. 


3.3.4.10 LS/LP - The following problems with the LS and LP handlers have been 
corrected: 


CTS-300 SYSGEN now builds the LS handler for Professional 300 series 
processors. 


A coding error in the handler sometimes caused loss of characters when 
you ran RT-11 on a Professional series machine. That problem has been 
corrected. 


3.3.4.11 Magtape Handlers (MM,MS,MT,MU) - The following problem correction 


applies 


to all magtape handlers. Corrected problem information for specific 


magtape handlers is listed under the particular handler name. 


Previously, a .LOOKUP operation to the last file on a magtape would fail 
when the file structure module (FSM) within the magtape handler used the 
sequence number to access the last file immediately after creation. For 
RT-11 V5.4D, that operation succeeds under those circumstances. 


Previously, the FSM (file structure module) functioned incorrectly when 
a magtape was positioned after the last file and the /POSITION:n option, 
where n was the number of files on that magtape, was included in a COPY 
command. Those circumstances incorrectly returned the error message 
?PIP-F-File not found <dev:filenam.typ>. For RT-11 vV5.4C, the FSM 
functions correctly, and the file on a magtape is found and copied under 
those circumstances. 
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3.3.4.12 MM - The following problems with the MM handler have been corrected: 


Previously, the MM hardware handler for the XM monitor (MMHDX.SYS) would 
not work. For RT-11 V5.4C, the MMHDX.SYS handler works as documented. 
(You have to perform a SYSGEN to build that handler.) 


Previously, the MM handler could occasionally cause a system crash or a 
monitor trap to 4 condition when a hard error occurred during a write 
(.WRITE or .SPFUN 371) operation. For RT-11 V5.4B, the MM handler 
responds correctly by performing recovery or returning a hard error code 
under those circumstances. 


3.3.4.13 MQ - The following problem with the MQ handler has been corrected: 


Previously, the MQ handler used only the .READx wcnt parameter value to 
determine the size of a data transfer. A mismatch between the went 
parameter value for a .WRITx and a .READx request could cause data or 
code corruption. For RT-11 V5.4, the MQ handler uses the smaller of the 
.READx and .WRITx went parameter values to determine the data transfer 
size, and memory corruption can no longer occur under those 
circumstances. 


3.3.4.14 MS - The following problem with the MS handler has been corrected: 


Previously, a coding error in the MS handler could cause a system crash 
after MS attempted to recover from a tape drive unexpectedly going off 
line. For RT-11 V5.4C, the MS handler code is corrected, and that 
Situation can no longer crash the system. 


RT-11 V5.3 corrected a problem in which a double CTRL/C issued to a 
program using the MS magtape while it was in motion could cause the 
system to hang. That problem was caused by MS attempting to dismiss 
queue elements already dismissed by the monitor. 


3.3.4.15 MT - The following problem with the MT handler has been corrected: 


Previously, the MT handler could occasionally cause a system crash or a 
monitor trap to 4 condition when a hard error occurred during a write 
(.WRITE or SPFUN 371) operation. For RT-11 V5.4B, the MT handler 
responds correctly by performing recovery or returning a hard error code 
under those circumstances. 
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3.3.4.16 MU - The following problems with the MU handler have been corrected: 


The MU handler initializes the port interface between the processor and 
the TMSCP magtape controller when you use the drive for the first time 
after fetching or loading MU, or when a new magtape is mounted. 
Previously, aborting magtape operations by typing double CTRL/C during 
that port initialization procedure could hang your system. For. ET<i1 
V5.4B, aborting the port initialization does not hang your system. You 
can, however, experience a delay of up to 90 seconds before receiving 
the monitor prompt after aborting port initialization. 


Previously, aborting magtape operations by typing double CTRL/C while 
the system was .FETCHing or LOADing the MU handler could halt your 
system. For RT-11 V5.4B, you can successfully abort operations under 
those circumstances. 


Previously, the MU handler did not report EOT (end-of-tape) until the 
physical end-of-tape was reached with Write, Write Tape Mark, and Space 
Forward operations. For RT-11 V5.4A, the MU handler correctly reports 
EOT when it encounters the end-of-tape mark. 


Previously, you could crash the system if you issued the BACKUP command 
to MU under XM when MU was not loaded, and you then typed CTRL/C in 
response to the initial BUP console prompt. For RT-11 V5.4A, typing 
CTRL/C under those circumstances correctly exits BUP and does not crash 
the system. 


Previously, you could hang the MU handler if it was loaded in memory and 
an error caused the unit status to change to ’off-line’. For RT-11 
V5.4A, the MU handler does not hang under those circumstances. 


Through the SYSGEN process, you can generate an MU hardware handler that 
does not contain the file-structure module (FSM). Also, through SYSGEN, 
you can generate support for up to four device units. Previously, the 
hardware handler incorrectly marked as valid those device units not 
requested during SYSGEN. Attempts to access invalid device units could 
halt or hang the handler and crash the system. The MU handler 
controller revision checking program, MSCPCK.SAV, attempted to check all 
units not marked as invalid and therefore could halt or hang the 
hardware MU handler. 


For RT-11 V5.4A, the MU hardware handler correctly marks as valid only 
device units for which support is requested during SYSGEN. 
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3.3.4.17 NC/NQ/NU - The following problem with the NC, NQ, and NU Ethernet 
handlers have been corrected: 


@® Previously, the installation code in NU performed a self-test of the 
DEUNA or DELUA controller only if the controller had not successfully 
passed a self-test following the last power-up. For RT-11 V5.4C, the NU 
installation code has been modified to perform a controller self-test 
each time the NU handler is installed. 


® A problem occurred with processing queue elements on the NC and NQ 
handler’s internal receive queue. Depending on the number of receive 
requests outstanding and the order in which they were satisfied, queue 
elements could become lost, causing the system to hang. For RT-11 V5.4, 
queue elements are correctly processed on the internal receive queue. 


3.3.4.18 PI - The following problems with the Professional Interface (PI) 
handler have been corrected: 


® An error in the secondary device attribute escape sequence processing 
has been corrected. 


@ Horizontal tabs now work properly on a double-wide line. 


@ On Professional 300 series processors, the escape sequence <ESC>[0;0r 
(set top and bottom margins of scrolling region) was treated as invalid 
and ignored. That escape sequence is now processed as <ESC>[1;24r in 
accordance with the VT100 standard. 


3.3.4.19 RK - The following problem with the RK handler has been corrected: 


@ Previously, the RK handler did not account for the hardware differences 
between RKV11 and RK11 controllers regarding DMA transfer limits. Now, 
the RK handler returns a hard error if a transfer would have accessed 
memory beyond the limits addressable by the controller in use; that is, 
64K bytes on the Q-bus and 256K bytes on the UNIBUS. 


3.3.4.20 TL - The following problem with the TT handler has been corrected: 


@ When running under the SJ monitor, the TT handler prompted with an up 
arrow (*) for every .READ request rather than correctly prompting only 
when the .READ request specified block 0 as the starting block. Now, 
the TT handler prompts only for a block 0 .READ request. 
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VM - The following problems with the virtual memory (VM) handler have 


been corrected: 


Previously, the system crashed after you installed VM if the BASE was 
SET beyond the end of available memory. Now, the error message 
?KMON-F-Invalid device installation xx:VM.SYS is displayed. 


VM failed to turn on 22-bit addressing when the boot code base address 
in extended memory was set at or slightly above the 18-bit/22-bit 
boundary. VM now correctly turns on 22-bit addressing when the boot 
code base address is set at or above the 18-bit/22-bit boundary. A 
further refinement was made to the VM code for RT-11 V5.4 that 
completely resolved this problem. 


3.3.5 System Generation 


The following problems in the system generation program SYSGEN have been 
corrected: 


If an answer file was used as input to SYSGEN to generate a system for 
CTS-300, SYSGEN would not generate new printer source files. Now, 
SYSGEN.COM generates new source files, if necessary, when an answer file 
is used as input. The .CTS answer file created by SYSGEN shows the 
number of printers (LPNUM) requested and the CSR and vector addresses 
for each printer. 


SYSGEN included the conditional LSSPC in the .CND file only when both LS 
PC300 printer port and LP device support were specified. LSSPC is now 
included when only LS PC300 printer port support is specified. 
Selecting LP support is no longer required to set SYSGEN conditional 
LSSPC = 1. 


A special dialog for Professional/CTS V01.0 support has been added to 
SYSGEN. To initiate the dialog, the file PROCTS.ANS must be on the 
default volume. 


3.3.6 System Macro Library (SYSMAC) 


The following problems with programmed requests in the system macro library 


(SYSMAC) 


SS. Ped 


have been corrected: 


-ABTIO 


The .ABTIO request incorrectly aborted all of a job’s outstanding 1/0 
operations; that is, it aborted all outstanding I/O on all channels. 
Also, all aborted I/O queue elements were lost. Now, .ABTIO correctly 
aborts a job’s outstanding 1/0 operations only on the specified channel. 
The aborted I/0 queue elements are correctly returned to the list of 
available queue elements. See the System Macro Library section in 
Chapter 2 for details. 
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- OSET 


@ When running under the XM monitor, .QSET incorrectly returned the number 
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of queue elements requested in RO. Now, .QSET correctly returns the 
address of the first word beyond the allocated queue elements in RO. 


- RSUM 


Previously, if a program issued more than 32767 .RSUM requests, 
unexpected results occurred. More than 32767 .RSUM requests caused the 
16-bit word containing the count to overflow, and the .RSUM request then 
had the effect of a .SPND request. For RT-11 V5.4D, the resume count is 
held at the highest positive number, and the effect of the request does 
not change. 


- SPFUN 


Previously, directing a .SPFUN 373 to a logically possible but 
physically nonexistent DM device did not return an error. Instead, it 
returned an incorrect size. For RT-11 V5.4B, directing a .SPFUN 373 to 
a logically possible but physically nonexistent DM device correctly 
LECUING a0 error. 


- SPND 


Previously, if a program issued more than 32767 .SPND requests, 
unexpected results occurred. More than 32767 .SPND requests caused the 
16-bit word containing the count to overflow, and the .SPND request then 
had the effect of a .RSUM request. For RT-11 V5.4D, the suspend count 
is held at the lowest negative number, and the effect of the request 
does not change. 


3.3.7 System Subroutine Library (SYSLIB) 


The following problems with subroutines in the system subroutine library 


(SYSLIB) 


have been corrected: 
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CONCAT 


A problem in the CONCAT function caused incorrect error reporting. An 
error was not correctly reported when both the length specified for the 
output string was shorter than the first input string, and the address 
of the first input string fell on a block boundary. CONCAT now 
correctly reports errors. 


ITASIGN 


IASIGN could suppress console (TT) carriage control if it was called 
before any output was sent to the console. Now, IASIGN no longer 
Suppresses console carriage control if it is called before output is 
sent to the console. 


If a program did not specify carriage control, IASIGN set the default 
carriage control to expanded. Now, if carriage control is not 
specified, IASIGN causes the FORTRAN OTS to send expanded carriage 
control information to the terminal and line printer and unexpanded 
Carriage control information to all other devices and files. 


IASIGN has been removed from SYSLIB and added to the FORTRAN IV 
distributed FORLIB and the FORTRAN-77 distributed F770TS libraries. 


ICHCPY 


Previously, ICHCPY incorrectly interpreted the optional jobblk 
parameter. A value specified for the first word of jobblk was 
incorrectly used as the location of the string rather than correctly as 
the first word of the string itself. For RY-li V5.4, the ICHCEY 
subroutine works as documented. 


IGETR 


Previously, IGETR could not be called from a FORTRAN program. Also, 
numerous problems occurred in the code with information mapping, Sizing, 
and channel operations. For RT-11 V5.4, IGETR works as documented. See 
Section 3.4.5 for more information and an example program using IGETR. 


ILUN 


The ILUN function called the FORTRAN OTS routine, SFCHNL, and returned 
the RT-11 channel number associated with a specific FORTRAN LUN. The 
SFCHNL routine assigned a channel number to a LUN if it was not already 
assigned one. When a user program looped to determine to which channels 
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the LUNs were assigned, the program would eventually fill the channel 
address table and cause FORTRAN Error 21 (out of logical units). The 
ILUN function now calls a local copy of the SFCHNL routine. $FCHNL no 
longer assigns an available channel to an unassigned LUN. 


ILUN has been removed from SYSLIB and added to the FORTRAN IV 
distributed FORLIB and the FORTRAN-77 distributed F770TS libraries. 


INDEX 


Previously, INDEX incorrectly returned a 1 in the integer variable 
(parameter m) when the first byte of the string being sought (parameter 
pattrn) was a null. INDEX now correctly returns a 0 under those 
circumstances. 


INTSET 


The linkage established by INTSET between the processor and device 
priorities was performed improperly, which resulted in the processor 
executing the interrupt at a processor priority level that was lower 
than the device priority level. Now, the processor executes the 
interrupt when the processor and device priority levels are the same. 


INTSET has been removed from SYSLIB and added to the FORTRAN IV 
distributed FORLIB and the FORTRAN-77 distributed F770TS libraries. 


JREAD / JREADC/ JREADW 


Previously, the various JREAD subroutines did not use the 
device-identifier byte to validate a device. Rather, the JREAD 
subroutines checked the device handler’s name against the string "DU". 
Consequently, the JUREAD subroutines incorrectly returned an ’invalid 
device’ message when used with a renamed DU handler. For RT-11 V5.4C, 
the JREAD subroutines correctly use the device-identifier byte to 
validate devices and to function correctly with renamed DU handlers. 


JWRITE/JWRITC/ JWRITW 


Previously, the various JWRITE subroutines did not use_ the 
device-identifier byte to validate a device. Rather, the JWRITE 
subroutines checked the device handler’s name against the string "DU". 
Consequently, the JWRITE subroutines incorrectly returned an ‘invalid 
device’ message when used with a renamed DU handler. For RT-1l1 V5..80, 
the JWRITE subroutines correctly use the device-identifier byte to 
validate devices and to function correctly with renamed DU handlers. 
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3.3.7.10 MRKT 


Previously, MRKT incorrectly interpreted the id parameter. The value 
specified for the id parameter was incorrectly interpreted as the 
address of the id parameter rather than correctly as the id parameter 
itself. Now, the MRKT subroutine works as documented. 


3.3.7.11 MYTIN, MTOUT 


The optional argument ocnt in the MTIN and MTOUT subroutines returned 
the value zero regardless of the setting of bit 6 in M.TSTS. The 
optional argument ocnt now returns a value equal to the number of 
characters transferred on return from the subroutines when bit 6 of 
M.TSTS is set. 


3.0./.12 SCOPY 


SCOPY did not set the err argument (to .TRUE.) when the input and output 
arguments specified the same array name, and the input array was 
correctly truncated to the value specified in the len argument. Now, 
the err argument is correctly set (to .TRUE.) under those circumstances. 


3.3.8 MACRO-11 Assembler 


The following corrections have been made to the MACRO-11 assembler: 


Previously, MACRO-11 parsed arguments on .IF statements that were within 
unsatisfied conditional code blocks. MACRO-11 could return assembly 
errors (error code A) on lines of code that should not have been parsed. 
For MACRO-11 Version 5.4, MACRO-11 correctly keeps only a conditional 
nesting count and does not parse arguments of conditional statements 
within unsatisfied blocks of code. 


Previously, invalid nonprintable characters in MACRO-11 source code were 
not detected and flagged as errors. For MACRO-11 Version 5.04, invalid 
nonprintable characters are detected and flagged with an ’I’ error. 


Previously, the utility CREF.SAV did not produce a correct 
cross-reference of a MACRO-11 program that contained more than 999 lines 
of code. For MACRO-11 Version 5.04, CREF.SAV produces correct 
cross-references under those circumstances. 


See Appendix J of the PDP-11 MACRO-11 Language Reference Manual, Update 2, for 
other corrections to the MACRO-11 assembler. 
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3.3.9 Error Severity Levels 


Error level descriptions were inconsistent throughout the RT-11 documentation. 
They have been corrected and made consistent. 


3.3.10 Miscellaneous Corrections 
The following miscellaneous problems have been corrected: 


STARTF .COM The /BUFFER:256. option has been added to the FRUN SPOOL and 
SRUN SPOOL commands. Also, the SET USR NOSWAP command has been 
added before the spooler related commands, and the SET USR SWAP 
command has been added after the spooler related commands. 


VOUSER. TXT The system introductory text now includes a reference to the file 
VONOTE .TXT. 


3.4 DOCUMENTATION CORRECTIONS AND ADDITIONS 


This section contains information that was incorrect in or inadvertently left 
out of the RT-11 documentation set. 


3.4.1 RT-11 System Utilities Manual 


This section contains corrections or additions to the RTI-11 System Utilities 
Manual: 


@ LD (logical disk subsetting program) 


Chapter 9 does not include specific information on creating logical 
disks. See Appendix D of this manual for complete information about 
logical disks. 


@ LINK Cross-Reference Option (/N) 


The last two paragraphs in Section 11.6.13, Cross-Reference Option (/N), 
contain inaccurate information. LINK does not first attempt to generate 
the temporary file CREF.TMP on the DK device. In fact, LINK first 
determines if a device has been ASSIGNed the logical name CF, and if so, 
LINK uses that device to generate CREF.TMP. LINK only uses the DK 
device to generate CREF.TMP if no device has been assigned the logical 
name CF. 


e Using ELINIT 


The following information is not included in Section 16.4.1 of the AT-11 
System Utilities Manual, Using ELINIT: 
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When you RUN ELINIT (or R ELINIT) followed by a carriage return and you 
receive the prompt requesting the device to which you want the | ) 
statistics file ERRLOG.DAT written, you can press RETURN to select your 

system device (SY) or you can specify a device. If you specify a 
device, you must include a colon (:) following that device; for example, 

Dicks Also, do not specify a file name in response to that prompt; only 

the file name ERRLOG.DAT is valid. 


For RT-11 V5.4, if you do not specify a valid device in response to the 
ELINIT prompt requesting the device to which you want the statistics 
file ERRLOG.DAT written, ELINIT checks the default data device (DK) for 
ERRLOG. DAT. If ERRLOG.DAT is not on DK, ELINIT returns the warning 
message, ?ELINIT-W-File not found DK:ERRLOG.DAT. ELINIT then writes 
ERRLOG.DAT on DK. If you specify a valid device that does not contain 
the file ERRLOG.DAT, ELINIT returns the warning message, ?ELINIT-W-File 
not found <ddn:ERRLOG.DAT>, where ddn: is the device you specified. 
ELINIT then writes the file ERRLOG.DAT on that device. 


3.4.2 RT-11 Installation Guide 
This section contains corrections or additions to the R7T-11 Installation Guide: 
e Section 2.3.8, Line Printer Handlers 


The information in this section, starting at the second paragraph, is 
incorrect. Do not rename your serial interface printer handler LS.SYS | 
or LSX.SYS to LP.SYS or LPX.SYS. (The X suffix indicates a handler for 
the XM monitor.) 


Substitute the following information for the entire Section 2.3.8: 


The software distribution kit includes the parallel interface 
printer handlers LP.SYS or LPX.SYS and the serial interface printer 
handlers LS.8iS er LSx,.SYye. If your hardware configuration 
includes a serial interface printer instead of a parallel interface 
printer, you should include only LS.SYS or LSX.SYS in your working 


system. J 
You use the serial interface printer handler the same way you use 


the parallel interface printer handler. However, you should 
include the following command line in your start-up command file: 


ASSIGN LS LP 


If your serial interface printer is installed at nonstandard vector 
and control status register addresses, use the SET command to 
change the addresses (see Section 2.7.11.1). See the R7-11 System 
User’s Guide for all LS handler SET commands. 
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@® Modifying the Help Text (Section 2.7.14) 


f ! 
The command to merge the HELP program (.EXE) and library (.MLB) located 
above the last paragraph of this section should read: 
.COPY/CONCATENATE HELP.EXE,HELP.MLB HELP.SAV <RET> 
e Preserving the Working System (Section 8.9) 
The commands shown to initialize magtapes for MS and MU devices are 
incorrect. 
The correct primary bootstrap file for MS magtapes is MBOT16.BOT. 
Therefore, the correct command to initialize an MS device magtape for 
this procedure is: 
. INITIALIZE/FILE:MBOT16.BOT MSO: <RET> 
° . ? 
loos MSO:/INITIALIZE; Are you sure? Y <RET> 
The correct primary bootstrap file for MU magtapes is MBOOT.BOT. 
Therefore, the correct command to initialize an MU device magtape for 
this procedure is: 
. INITIALIZE/FILE:MBOOT.BOT MUO: <RET> 
MU0:/INITIALIZE; Are you sure? Y <RET> 
is \ 
| The rest of the procedure is correct. 
@ Appendix Section B.8, Loading the TSV05 Bootstrap Using MICRO-ODT 
Step 6 does not contain complete information. It should read: 
6. Finally, enable the processor (remove the halt condition) and 
type: 
y | 10000G 
(The rest of the information is correct.) 
@ Creating a Bootable Magtape 
Chapter 8 does not include specific information on creating a bootable 
magtape. See Section 1.5.9 of this manual for information on creating a 
bootable magtape. 
3.4.3  RY-11 System User’s Guide 
This section contains changes and corrections to the RT-11 System User’s Guide: 
rr, 
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e COPY command, /DEVICE option 


This section inaccurately states that when data is written from disk to 
magtape, that data is stored on tape formatted in 1K-word blocks. In 
fact, data is formatted in 256-word blocks. Also in the same paragraph, 
it is inaccurately stated that only one disk image can be copied on a 
magtape. In fact, more than one disk image can be copied to a magtape, 
using the /DEVICE option. The rest of that section is accurate. 


@® DIFFERENCES command 


The /SLP[:filespec] option for the DIFFERENCES command is not correctly 
documented. You must specify an output filespec; it is not optional. 
The correct syntax is DIFFERENCES/SLP:filespec. 


@ LIBRARY command 


The /MACRO[:n] option is incorrectly described. The n is incorrectly 
described as being the size in blocks, when in fact n is the number of 
macro names that can be stored in the directory. The default value for 
n is 128 (which uses two blocks for the macro name table). The rest of 
the description is correct. 


e SET DU RETRY=n command 


The DU handler is incorrectly listed under the dd: RETRY=n command 
section. The description of the dd: RETRY=n command states that the 
Error Logger utility must be running to enable that command, which is 
not true in the case of DU. When you SET DU RETRY=n, you modify without 
restriction the number of times the handler attempts error recovery. 


e SET LS WIDTH=n command 


The maximum value for n in this command description is incorrectly 
listed as 255. In fact, the maximum decimal integer line width you can 
specify for the SET LS WIDTH=n command is 32767. The rest of the 
command description is correct. 


® Section 5.2.1.3, Suppress Console Display Option (/Q) 
This section inaccurately states that the /Q option suppresses the 
display of keyboard commands and their results, as IND executes the 
keyboard commands. In fact, the /Q option only suppresses keyboard 


commands; the /Q option does not suppress the results of keyboard 
commands. 


3.4.4 RYT-11 Software Support Manual 


This section contains changes and additions to the RY-11 Software Support 
Manual: 
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@® Chapter 3, Resident Monitor 
3.5.7, Message Handling 


This section should contain the following information about FB monitor 
Support for message transfers: 


The distributed FB monitor only supports using the 
.SDAT/.RCVD/.MWAIT requests to transfer messages. 


You must build (SYSGEN) an FB monitor and request system job support (or 
use XM) to transfer messages, using the system job lookup macro 
(.LOOKUP) and the standard I/O requests. (You can also continue to use 
the .SDAT/.RCVD/.MWAIT requests to transfer messages between the 
foreground and background programs when you run any FB or XM monitor.) 


@ Chapter 5, Multi-Terminal Feature 
5.14, Multi-Termminal Example Program 


The example program contains code in two places that can cause the 
program to fail. 


The code between symbol 6$: and symbol LOGLUN: should be changed to 
the following: 


65: Bis #<TTSPCS !TCBITS>, @R3 
MOV #ENDTBL, R4 
MOV #32, LOTIM ;Inserted line 


CALL TERMID 
CALL RSET 
BR 35 


The line at symbol UNKTT: onthe last page of the example program 
should be coded for five spaces before the text: 


UNRTT:° .RSCIE / unidentifiable terminal/<200> 
The rest of the program is correct. 
® Chapter 7, Device Handlers 
7.2.1.3 Device Status Word 


The comment for the symbol SPECL$ (bit 12), ;NO DIRECTORY, is incorrect. 
The line for the symbol SPECLS$ should read: 


SPECL$ == 10000 ;SPECIAL DIRECTORY STRUCTURED DEVICE 

Also, below Table 7-2, the stat argument for the LP handler should read: 
Por LP: WONLYS!SPECLS 

7.8.2, How to Support Special Functions in a Device Handler 


This section incorrectly states in the fourth paragraph that you should 


be 
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return a hard error for invalid special function codes. In fact, device 
handlers should simply ignore invalid special function codes. 


7.9.8 Extended Memory Subroutines 


The description of the XALLOC subroutine for obtaining free memory does 
not make clear that the size argument passed in R2 is in units of 
32(decimal) words. For example, to allocate 32000. words, specify 
1000. as the size argument passed in R2. 


Also, if the required amount of memory is available, the carry bit will 
be clear, and Rl contains the region address divided by 32(decimal). 


Chapter 8, File Formats 
Figure 8-35: Object Library Header Format 


The descriptions for Offset 10 and Offset 20 are reversed. Offset 20 in 
the figure is incorrectly described as ’1 if library created with /X 
option’. That description applies to Offset 10. Offset 20 should be 
described as ’Reserved’. 


The description for Offset 30 is incorrect. Offset 30 should be 
described as ‘Size (bytes) of directory and header’. 


Chapter 10, Programming for Specific Devices 
EOF (end-of-file) detection for TT, XC, and XL: 


The following information concerning end-of-file detection for the TT, 
XC, and XL handlers is not included in Chapter 10: 


A CTRL/Z within data being read from the TT, XC, or XL device is treated 
as end-of-file (EOF) by the .READ request. At least two .READ requests 
are necessary to return the EOF error (carry bit set and byte 52 
containing error code 0). The first .READ request transfers into your 
buffer all data up to (but not including) the CTRL/Z. The rest of the 
buffer is padded with nulls. A second .READ request is required to get 
the EOF error. Subsequent .READ requests can return additional 
characters. 


Section 10.14.3, Example of Allocating an Ethernet Unit 

The following example program contains code supporting the NU Ethernet 
handler along with support for NC and NQ. The example program in 
Section 10.14.3 is accurate but does not include support for NU. 
Support for the NU Ethernet handler is new for RT-11 V5.4. 


The program works for Professional 300 series processors, Q-bus 
processors, and UNIBUS processors and maintains job separation. 
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CONFGZ = 370 ;Config word 2 

; (RMON fixed offset) 
PROSS = 020000 ;RT 1S running on a PRO-3xx 
BUSS = 000100 ;Q-bus/UNIBUS processor 


.GVAL #AREA,#CONFG2 ;Get contents of Config word 2 


MOV #<“RNC >,DBLK ;Assume PRO 
BIT #PROSS, RO ;Correct assumption? 
BNE 10S ;yes... 
MOV #<“RNQ >,DBLK ;No, SO assume Q-bus 
BIT #BUSS,RO ;Correct assumption? 
BNE 10$ PVOSws 4 
MOV #<“RNU >, RO ;Nope, must be 
,; UNIBUS after all 
105+ .GTJB  #AREA,#JOBDAT ;Get info on this job 
MOV JOBDAT, RO ;RO = job number (*2) 
ASR RO ;Convert to job number 0-7 
ADD #<“R 0>,RO0 ;Make it final RAD50 digit 
ADD RO, DBLK ; and edd it to 


; the device name 
. LOOKUP #AREA,#0,#DBLK ;Open a channel to Ethernet 


; LOOKUP error processing 


.SPFUN #AREA, #0,#200, #BUFFER, #0, #1 
;Allocate the unit to this job 


; SPFUN error processing 


AREA: ._BLKW 3 


JOBDAT: .BLKW 12. 
DBLK: . WORD OF Uso, o 
BUFFER: .BLKW 4 


;END OF EXAMPLE 


Section 10.15.1, (MU) Use of Special Functions (SPFUN) 

This section does not include the definitions for the request arguments 
when you use .SPFUN 360 with MU. The correct request syntax and 
definitions for the request arguments are: 

Macro Call: .SPFUN area, chan, func,buf,wcnt,blk 

where: 

area is the address of a 6-word EMT argument block 

chan is a channel number in the range 0 to 376(octal) 


func is 360, the MU/DU BYPASS function code 


buf is the address of the 52(decimal)-word TMSCP area 


Ee i 
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went when nonzero, is the virtual address of a data buffer to send to 
the handler. That virtual address is converted to a physical 
address and placed in the buffer of the TMSCP area 
when zero, the buffer address in the TMSCP area is not altered 


blk indicates whether the handler should perform retries: 


1 = specifies retries 


0 = specifies no retries 


Section 10.15.2, (MU) Unit Support, CSR, and Vectors 


This section contains inaccurate information. In fact, as distributed, 
MU supports one unit. You can use the system generation procedure to 
build support for up to four units. Each unit does require a separate 
controller. You can only boot RT-11 from MUO, and MUO must be installed 
at CSR address 774500 and vector 260. The addresses for MU1 through MU3 
float; they depend on what other devices are on the bus. The default 
CSR and vector assignments are as follows: 


CSR Vector 
774500 260 
774504 340 
774510 344 
774514 350 


Chapter 11, Specifics for Professional 300 Series Processors 
11.2.3, Device Attributes (DA) 


This section incorrectly states the form of SETUP VT100 DA response and 
the secondary DA response for FB and XM monitors. 


If the terminal is SETUP VT100, the correct DA responses are: 
When running under the FB monitor: <ESC>[?1l;1c 
When running under the XM monitor: <ESC>[?1;3c 
The correct forms for the secondary DA response are: 
For the FB monitor, the response is of the form: 
<ESC>[>7; VVNNc 
where VV is the version and NN is the edit level. 
For the XM monitor, the response is of the form: 


<ESC>[>8;VVNNc 
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where VV is the version and NN is the edit level. 


The rest of the information in Section 11.2.3 is correct. 


3.4.5 RT-11 Programmer’s Reference Manual 


This section contains changes and additions to the RI-1l Programmer’s Reference 
Manual: 


@e Chapter 1, Introduction to Advanced RT-11 Programming 
Completion Routines (Section 1.2.1.2) 


The following information concerns possible stack overflow under the FB 
and SJ monitors, when you use a subroutine that calls a completion 
routine. 


If your program is using a subroutine that calls a completion routine 
and you receive the message, ?MON-F-Trap to 4 (under the FB monitor) or 
?MON-F-Stack overflow (under the SJ monitor), you should relink your 
program and increase its stack size. You increase the stack size of 
your program by raising the program base address, using the LINK 
/BOTTOM:value option. By default, LINK places the program base address 
at 1000(octal). Raise the base address and thereby increase the stack 
size by specifying a /BOTTOM:value address in the range of 1010 to 
1200 (octal). 


@® Chapter 2, Programmed Request Description and Examples 
.CRAW Request Example Program 
The example program located at the end of Section 2.11 does not 
correctly handle the current number of error codes that can be returned 
by the .CRRG programmed request. The code should be modified in two 
places: 


At the label ERROR: 


ERROR: MOVB #’0,ERRNO2 ;Set up first digit 

MOVB @#ERRBYT, RO ;Get error byte code 

CMP RO, #10 ;If larger than 10, 

BLT 805 r 

INCB ERRNO2 ;Make lst digit ‘1’, 

SUB #10,R0 ; and 2nd digit value-10 
80S: ADD #70,R0 ;Make 2nd digit 

MOVB RO, ERRNO3 ;Put it in error message 

.PRINT #ERR oo 2 qu bio ees bs Cag 


At the label ERR: 


ERR: ASCII /?XMCOPY-F-Request of I-O error #/ 
ERRNO: .ASCII /0/ 
ASCII /, CODE=/ 
ERRNO2: .ASCII /0/ 
ERRNO3: .ASCIZ /0/ 


a 
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ERRBUF: .ASCIZ /?Data Verification Error?/ 
. EVEN 

ENDCRE =. *For CSIGEN - XM handlers loaded ! 
. END START 


-CSIGEN Request 


The description of the .CSIGEN request incorrectly states that it closes 
channels 0 through 10(octal). In fact, .CSIGEN under the FB and XM 
monitors performed a purge of those channels. For RT-11 V5.4, .CSIGEN 
performs a purge of those channels under all monitors. Also, if CSI 
errors are detected, .CSIGEN purges channels 0 through 10(octal) under 
all monitors. 


-CSIGEN Request, Section 2.12.1, Passing Option Information 


This section does not explicitly state that .CSIGEN and .CSISPC parse 
options and their associated values in reverse order from that specified 
on the command line. That is, the last option (and associated value if 
present) is placed last on the stack and therefore is the first option 
retrieved. That information iS given implicitly in the examples, which 
are correct. 


-DRBEG Macro 

The first sentence of the first paragraph is no longer accurate. In 
fact, .DRBEG now sets up the first six (not five) words of the handler. 
See Section 2.39 of this manual for information on the sixth word. 


-DRINS Macro 


The information in the first paragraph concerning RESORC and display 


CSRs is inaccurate. In fact, RESORC initially attempts to display the | 


installation check CSR address (located at symbol INSCSR) and not the 
display CSR address. RESORC shows only the display CSR address (located 
at symbol DISCSR) when the value at symbol INSCSR is zero. In either 
case, RESORC displays only one CSR address. The rest of the .DRINS 
macro description is accurate. .DRINS does cause all specified CSR 
addresses to be located in the device handler installation code as 
documented. 


- LOOKUP Standard Lookup 

The description for value 0 for the optional seqnum parameter is 
incorrect. In fact, specifying a value 0 means rewind to the beginning 
of the tape. If the file name is null, a nonfile-structured lookup is 
performed. 

The rest of the section is correct. 


Multiterminal Example Program MTXAMP .MAC 


Three areas in this program have a coding error or omission that can 
cause the program to fail. 
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The code following the first occurrence of the symbol 305 should read: 


308: ADD #2,R2 
INC R1 
CMP R1,R4 
BLOS 10$ ;Was BLO 
LOOP : 
CLR Rl 
MOV #AST,R2 
105* TDLs TAT (R1) 
BEQ 20$ 
BIT #AS INP, (R2) 
BEQ 20$ 
.MTIN #MTA, #MTCHAR, R1, #1 
BCS ERR 
CMPB MTCHAR, #CTRLC ;Inserted line 
BEQ DONE ;Inserted line 
.MTOUT #MTA, #MTCHAR,R1, #1 
BCS ERR 
206: ADD #2,R2 
INC Rl 
CMP R1,R4 
BLOS 10$ ;Was BLO 


The rest of the example is correct. 
-READC Request 


The last sentence in the paragraph following the .READC request syntax 
states that the completion routine will never be entered if the .READC 
request returns an error. That is correct when .READC is used with any 
DIGITAL hardware. However, that might not always be correct when .READC 
is used with non-DIGITAL hardware. 


Under rare circumstances, a completion routine could be entered even 
when .READC returns an error. For that to occur, a very high-speed 
non-DIGITAL device would have to return a hard error during a= short 
window that exists between two sections of hardware error processing 
code in .READC. The first section checks for hard errors reported by 
the previous request - the second for hard errors for this .READC 
request. The completion routine can be entered before .READC returns 
for the second hardware error check. 


-SCCA Request 


The description of the .SCCA request should mention that it is only 
available under the FB and XM monitors. The .SCCA request is also 
incorrectly listed in Table 1-4: Programmed Requests for All RT-1ll 
Environments. The .SCCA request should be listed in Table 
1-5: Foreground/Background and Extended Memory Programmed Requests. 
Given those corrections, the description of the .SCCA request is 
otherwise correct. 


-SFDAT Request 


The first sentence of the description of the optional fourth argument, 
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date, 1s incorrect; date 1s not the address of the new date. Rather, 
date is the new date value, in RT-11 format. The rest of the 
description is correct. 


.SPFUN Request 


The functions Forward one block and Backspace one block (function codes 
376 and 375) for devices MM, MS, MT, and MU are incorrectly described. 
Those functions do not necessarily act on only one block but instead on 
n blocks, where the value for n is supplied in the went argument. The 
description for those functions should read: 


Function MM, MS , MT, MU 
Forward n blocks* Wis 
Backspace n blocks* 213 


* The value for n is supplied by the went argument. 


Therefore, the first two sentences in the paragraph above the function 
table should be replaced with the following: 


The chan argument is the same as defined for the .READ/.WRITE 
requests. The contents and meaning for the blk and went arguments 
are specific to the .SPFUN request in which they are _ used. See 
Chapter 10 of the RT-11 Software Support Manual for information. 
If the crtn argument is left blank,...(the rest of the paragraph is 
correct). 


- TTYIN/ . TTINR 


For RT-11 V5.4C, the single-line command editor (SL) no longer ignores 
the state of bit 6 (inhibit TT wait) of the JSW. Setting bit 6 of the 
JSW now disables the SL editor. 


Chapter 3, System Subroutine Description and Examples 
CONCAT Subroutine 


The err argument is a logical error flag of data type LOGICAL*1; not 
Simply LOGICAL. It 1s especially important to use the LOGICAL*1 form 
when you use the FORTRAN-77 compiler. 


The description of the len argument implies that the output string is 
always truncated to the specified value. That is not correct. The 
output string is truncated to the value specified in the len argument 
only when the size of the concatenated string (a concatenated with b) is 
larger than the value specified in the len argument. 


GTJB/IGTJB 


You must include a valid ASCII job name in the jobblk parameter to 
obtain a 12-word block; simply including a comma after the addr 
parameter obtains an 8-word block. Also, the example program is 
incorrect; you cannot use a job number for the jobblk parameter - you 
must use a valid ASCII job name. 


ed 


CURRENT RESTRICTIONS AND CORRECTED PROBLEMS 


ICSI 


The option parameter description does not include the following 
information: 


ICSI parses options in reverse order from that specified on the 
command line. Therefore, ICSI places options in the INTEGER*2 
array in reverse order from that specified on the command line. 
That is, the last option on the command line is placed first in the 
array, which is only Significant if you have multiple occurrences 
of the same option in the command line. 


IFREEC 


Error code 1, Specified channel is not currently allocated, is 
incorrect. The error code is actually -1. 


IGETR 


The description of the IGETR system subroutine does not contain the 
following information: 


@ The description of the optional parameter, file, contains misleading 
and inaccurate information. Use the following information instead: 


file is the address of a 4-word RAD50 file specification. 
The specified file contains initialization data to 
open and read. (RT-11 recognizes the file parameter 


is ’file’ and not ’chan’ because the first word of the 
file specification, as a valid RAD50 device 
specification, contains a value greater than 
255 (decimal) .) 


The value in the blk argument cannot be -l. Rather, 
the value must be the number of the first block to use 
in a file that initializes the global region or zero. 
See the blk argument description. 


® The argument parameters, offset and msize, are in reverse order in 
the documented IGETR subroutine syntax and the parameter list. In 
fact, the correct syntax is [,msize[,offset]]. 


@ The description of the IGETR system subroutine does not indicate the 
method you should employ to use IGETR from within a FORTRAN program. 
There is no example showing how to force the addr parameter to begin 
on a PAR boundary. The following information and example show how to 
do that. 


As documented, the addr parameter is a variable. The base address of 
that variable is used for the global region. That variable must 
reside on a PAR boundary. Therefore, the variable’s address must be 
a 4K-word multiple from 000000. 
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Use the following procedure to place the variable on such an address 


(the example program below uses the variable names mentioned in the 

procedure) : 

1. Create an INTEGER*2 array of one element. (That array is xX in 
the example.) 7 

2. Create an INTEGER*2 index for that array. That index (called 
INDX in the example) contains the desired octal PAR boundary 
value minus the assembled address of the array X, divided by two, 
plus one. Those contents produce the offset into the array that 
falls on the PAR boundary. 

3. Use the array at the calculated index as the address (addr 
parameter) in IGETR, forcing the addr parameter to a PAR 
boundary. 

4. The following restrictions apply when using IGETR with FORTRAN IV 


and FORTRAN-77: 


@e If you are using FORTRAN IV, do not generate your OTS with 
the V2S array subscript bounds checking module - use the V2SN 
module instead. 


® If you are using FORTRAN-77, do not enable array subscript 
bounds checking (do not use the /I compiler option). 


The following example program illustrates the procedure discussed 
above. The program tests the four methods of calling IGETR: 
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TO DEMONSTRATE INITIALIZING A GLOBAL REGION FROM A FILE, COPY 
ANY ASCII TEXT (.TXT) FILE OF AT LEAST ONE BLOCK TO A FILE YOU 
CREATE NAMED TEST.DAT. THE FIRST 256 BYTES OF TEST.DAT IS 
USED AS THE INITIAL INPUT DATA FOR A GLOBAL REGION YOU CREATE 
USING THE FOLLOWING PROGRAM. 


INTEGER*2 RES, I, J, IPAR, CSIZ, MSIZ, OFS 

INTEGER*2 WRKA(7), INDX, OFFSET, X(1) 

INTEGER* 4 RNAME 

REAL*8 SPEC 

EXTERNAL SETREY 

DATA IPAR / "40000 / 

DATA CSig. «7 126 7, MSi2. 7 047,055 7 C7 

INDX = (IPAR - IADDR(X)) /2 +1 !CALCULATE INDEX 

OFFSET = INDX - 1 ! AND SUBSCRIPT OFFSET 
CALL IRAD50( 6, ’REYJUN’, RNAME ) ! MAKE RAD50 REGION NAME 


CALL IRAD50( 12, ’DK TEST DAT’, SPEC ) ! RAD50O TEST DATA FILE 


--------------------- TEST METHOD 1------------------------------ 


RES = IGETR( WRKA, ’P’, RNAME, X(INDX), CSIZ, MSIZ, OFS ) 
WRITE( 5, *) ‘TEST 1 RETURNED’, RES 
DO 10 I =1, 128 
X(OFFSET+I) = I 
CONTINUE 
DO 20 (1 -=.45 -13 
WRITE( 5, 1001) I, IPEEK( IPAR+((I-1) *2)) 
FORMAT ( ’ EXPECTED/FOUND: ’,16,’ / ’,16) 
CONTINUE 
RES = IFREER( WRKA, ’E’ 


ICHAN = IGETC() 

IF (ICHAN .LT. 0) STOP ’- NO CHANNELS AVAILABLE’ 

RES = LOOKUP( ICHAN, SPEC) 

RES = IGETR( WRKA, ’A’,RNAME,X(INDX) ,CSIZ,MSIZ, OFS, ICHAN, 0) 
WRITE( 5, *) ‘TEST 2 RETURNED’, RES 

CALL CLOSEC( ICHAN ) 

CALL IFREEC( ICHAN ) 

RES = IFREER( WRKA, ‘E’ ) 
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RES = IGETR( WRKA,’ A’ ,RNAME,X(INDX) ,CSIZ,MSIZ,OFS,SPEC,0 ) 
WRITE( 5, *) ‘TEST 3 RETURNED’, RES 

WRITE( 5, 1002) (IPEEK( IPAR+((I-1) *2)),I=1,10) 

FORMAT( ’ STRING IN FILE: "’,10A2, '"’) 

RES = IFREER( WRKA, ’E’ ) 


RES = IGETR(WRKA,’ A’ ,RNAME,X (INDX) ,CSIZ,MS1IZ,OFS,SETREY, -1) 
WRITE( 5, *) ‘TEST 4 RETURNED’, RES 
DO 40 I =1, 10 
WRITE ( 5, 1001) I, IPEEK( IPAR+((I-1) *2) ) 
CONTINUE 
RES = IFREER( WRKA, ’E’ ) 
END 


SUBROUTINE SETREY( ADDR, LN ) ! CALLED BY IGETR 
INTEGER*2 I, ADDR, LN 
DO 10 1 = 1, in 
CALL IPOKE( ADDR+((I-1)*2), I) 
CONTINUE 
RETURN 
END 


TREAD / IREADC/IREADF / IREADW Ww 


Section 3.48, IREAD/IREADC/IREADF/IREADW, contains inaccurate 
information about the error codes returned for IREAD, IREADC, and 
IREADF. The normal return for IREAD, IREADC, and IREADF is 0 and not n. 
IREAD, IREADC, and IREADF cannot return the value for n, because the 
monitor returns control to the user program immediately after they are 
initiated. IREADW does return n as the normal return, because the 
monitor returns control to the user program at completion of the 
subroutine. The rest of the section is correct. 


ITRENAM 

Section 3.49, IRENAM, contains inaccurate information about the error 
codes it returns. Code 3 iS incorrect and code 4 is omitted. The 
correct descriptions of those codes are: 


i= 3 Device is currently in use 


= 4 A file by that name already exists and is protected 
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ISPFN Subroutines 


The functions Forward one block and Backspace one block (function codes 
376 and 375) for devices MM, MS, MT, and MU are incorrectly described. 
Those functions do not necessarily act on only one block but instead on 
n blocks, where the value for n is supplied in the went argument. The 
description for those functions should read: 


Function MM, MS, MT, MU 
Forward n blocks* 316 
Backspace n blocks* S19 


* The value for n is supplied by the went argument. 
IWRITE/IWRITC/IWRITF /IWRITW 


Section 3.68, IWRITE/IWRITC/IWRITF/IWRITW, contains inaccurate 
information about the error codes returned for IWRITE, IWRITC, and 
IWRITF. The normal return for IWRITE, IWRITC, and IWRITF is 0 and not 
Th IWRITE, IWRITC, and IWRITF cannot return the value for n, because 
the monitor returns control to the user program immediately after they 
are initiated. IWRITW does return n as the normal return, because the 
monitor returns control to the user program at completion of the 
subroutine. The rest of the section is correct. 


LOOKUP 

The description for value 0 for the optional seqnum parameter is 
incorrect. In fact, specifying a value 0 means rewind to the beginning 
of the tape. If the file name is null, a nonfile-structured lookup is 
performed. 

The rest of the section is correct. 

REPEAT 

The err argument is a logical error flag of data type LOGICAL*1; not 
Simply LOGICAL. It is especially important to use the LOGICAL*1 form 
when you use the FORTRAN-77 compiler. 

SCCA System Subroutine 


The description of the SCCA subroutine should mention that it is only 
available under the FB and XM monitors. 


SCOPY Subroutine 
The err argument is a logical error flag of data type LOGICAL*1; not 


Simply LOGICAL. It is especially important to use the LOGICAL*1 form 
when you use the FORTRAN-77 compiler. 
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The description of the len argument implies that the output string is 
always truncated to the specified value, which is not correct. The 
output string 1s truncated to the value specified in the len argument 
only when the size of the input string (in argument) is larger than the 
value specified in the len argument. 


STRPAD 
The err argument is a logical error flag of data type LOGICAL*1; not 
Simply LOGICAL. It 1s especially important to use the LOGICAL*1 form 
when you use the FORTRAN-77 compiler. 

e Appendix C, Running PRO/GIDIS Under RT-11 
In the first paragraph of Appendix C, the order number reference for the 


PRO/GIDIS Manual should read AD-Y660A-TK. The order number AD-Y660A-T1 
is for the first Update to that manual. 


3.4.6 RT-11 Mini-Reference Manual 


The following section contains additions and corrections to the  A&Y7-I11 
Mini-Reference Manual: 


e KMON Commands 
Library 
The /MACRO[:n] option is incorrectly described. The n is incorrectly 
described as being the size in blocks, when in fact n is the number of 
macro names that can be stored in the directory. The default value for 
nis 128 (which uses two blocks for the macro name table). 

@e Utilities 
Libr 


The /M:n option is incorrectly described. See the correction in the 
KMON LIBRARY command section above. 


@ Programmed Requests 
-DRBEG Macro 
The first sentence of the first paragraph is no longer correct. 151 


fact, .DRBEG now sets up the first six (not five) words of a device 
handler. The sixth word is described in Section 2.39 of this manual. 
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@® Data Structures 
Configuration Word 2 (RMON fixed offset 370) 
The meaning for the BUSS and PROSS bits is not clear. It should be: 
Name Bits Meaning 
BUSS 100 Set = Q-bus 


Clear = UNIBUS or CTI-BUS 
(check PROSS) 


PROSS 20000 Set = RT-11 running on a Professional 
series computer 


Clear = UNIBUS or Q-bus processor 
(check BUSS) 


3.4.7 RT-11 System Generation Guide 


The following section contains additions and corrections to the R7-1l System 
Generation Guide: 


@ SYSGEN dialog, question 184 
The first sentence of the explanation supplied for question 184 of the 
SYSGEN dialog contains incorrect information. That sentence should 
read: 
You can select RT-11 support for one DZ11-A or one DZ11-C 8-line 


multiplexor with an additional DZ11-B or DZ11-D 8-line multiplexor, 
for a maximum of 16 lines. 


3.4.8 Introduction to RT-11 


The following section contains additions and corrections to the Introduction to 
tat Hae 


@ Chapter 5, Creating and Editing Text Files 
Chapter 5 demonstrates the EDIT hard-copy editor. That editor is no 
longer the default RT-11 editor. Therefore, to start the EDIT editor, 


you must either SET EDIT EDIT and then issue the EDIT command or issue 
the command RUN EDIT (or R EDIT). 
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INSTALLATION, BOOTSTRAP, AND HARDWARE SETUP PROCEDURES 


This chapter describes procedures you may need to follow, depending on your 
distribution kit and your hardware configuration. Additional information for 
this chapter appears in two files on the RT-11 distribution kit: 


V5NOTE.TXT contains release note information formalized too late for 
inclusion in the printed release notes. 


CUSTOM.TXT contains a table that helps you determine the correct values and 
addresses to use when installing software customizations. 


Chapter 2 of the RT-11 Installation Guide provides and describes software 
customizations. In the customizations, symbols are used in place of values and 
addresses. When you install software customizations, use the values and 
addresses provided in CUSTOM.TXT in place of each symbol shown in the 
customization. 


You can use the on-line index utility, INDEX, to find more information on topics 
described in this chapter. 


4.1 FORMATTING DISKS ON PROFESSIONAL 300 SERIES PROCESSORS 


DIGITAL recommends formatting RD50, RD51, and RD52 hard disks before they are 
used. If you boot a Professional 300 series processor from a diskette and the 
processor contains an unformatted hard disk, a hardware diagnostic picture is 
displayed on the screen. The diagnostic picture displays the number 010030 
followed underneath by 000401, indicating an unformatted hard disk. Software 
cannot be installed on the hard disk. 


The RT-11 system boots from the diskette after displaying the diagnostic 
picture. Execute the following sequence of commands to format and install the 
hard disk: 


.FORMAT DW: 

. INSTALL DW: 

.LOAD DW: 

. FORMAT/VERIFY:ONLY DW: 


The command FORMAT DW: generates the informational message ?FORMAT-I-Install 
DW. Attempting to verify a hard disk with FORMAT/VERIFY or FORMAT/VERIFY:ONLY 
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before formatting an unformatted hard disk generates the error message 
?FORMAT-F-Invalid device for /VERIFY, or not formatted. 


4.2 PROCEDURES FOR DISTRIBUTION KITS 


All RT-11 distribution kits contain system software and automatic installation 
and verification software. However, automatic installation and verification is 
supported only with certain distribution kits: RL02, RX02, RX50, and TK50. Lt 
you attempt to bootstrap the automatic installation monitor (RT11AI.SYS for 
PDP-11 systems or RT11PI.SYS for Professional 300 series systems) on a 
distribution kit that does not support automatic installation, the installation 
procedure informs you that automatic installation is not supported, and you must 
install your system manually. 


You may need to follow one of the procedures described below, if your 
distribution kit does not support automatic installation or if your hardware 
configuration does not meet automatic installation requirements. 


@ When you bootstrap an RLO2Z, RX02, RX50, or TK50 distribution kit, the 
automatic installation monitor (RT11AI.SYS for PDP-11 systems or 
RT11PI.SYS for Professional 300 series systems) is bootstrapped. ae 
your hardware configuration meets automatic installation requirements, 
the installation procedure tells you how to _ proceed. (See the 
appropriate RT-11 Automatic Installation Booklet for more details on 
automatic installation.) If, however, your hardware configuration does 
not meet automatic installation requirements, the automatic installation 
procedure informs you that automatic installation is not supported, and 
you must install your system by following the procedures in the RT-11 
Installation Guide. If your configuration does not include a line clock 
or 24K words of memory (FB monitor requirements), you must first copy 
the bootstrap for the SJ monitor from RT11SJ.SYS to your system volume 
while still operating under the automatic installation monitor, 
Rite eoto- Of BILIP. -Sis3 


e RX01 distribution kits contain two copies of the RT-11 software, so you 
do not need to back up the distribution kit. Store one copy as your 
master distribution kit and bootstrap Volume 1 of the second copy to 
initiate system installation. Follow the instructions in the RT7-11 
Installation Guide. If you are following Chapter 3, you need not 
perform any of the operations described in Section 3.2 for preserving 
the distribution volumes, except for the instructions for removing 
protection from files beginning near the middle of page 3-6. 


@ Volume 10 of RX01 distribution kits includes the same software as the 
AUTO volume on kits that support automatic installation. That volume is 
also PDT-11/150 bootable. However, if you bootstrap that volume on a 
PDT-11/150, the installation procedure informs you that automatic 
installation is not supported, and you must follow the procedures in the 
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RT-11 Installation Guide to install your system. To create a 
PDT-11/150-bootable RT-11 distribution kit, you should respond to the 
keyboard monitor prompt (.) by using the COPY/BOOT command to copy the 


PD bootstrap to volume 1 of the RX01 distribution kit. 


4.3 MANUAL INSTALLATION OF THE TK50 SOFTWARE DISTRIBUTION 

The procedure to manually install the software distribution from a TK50 magtape 
is essentially the same as that described in Chapter 8 of the RT-11 Installation 
Guide. However, the TK50 magtape uses the new MU device handler, so you must 
specify the new magtape build program MDUP.MU in response to the MSBOOT prompt. 
The rest of the procedure is the same. 

If your processor does not contain the correct MU boot ROM and you want to boot 
your processor from a bootable TK50 magtape, you must manually load the TMSCP 


software bootstrap. You can load the TMSCP software bootstrap, using MICRO-ODT, 
or the console switch register if your processor has a console switch register. 


4.3.1 Loading the TMSCP Bootstrap, Using MICRO-ODT 

Deposit the TMSCP bootstrap loader in memory as follows: 
1. Place the bootable TK50 magtape in drive unit 0 and power-up the drive. 
2. Turn on your processor; if it is already on, halt it. 


3. At the console, type the first address from the table in Section 4.3.3 
(76026) followed by a slash (/): 


76026/ 


The system responds by printing the contents of address 76026 
(represented below by xxxxxx) on the console: 


76026/ xXxXxXXxx 


4. On the same line, type the first contents value from the table (5000) 
followed by a line feed: 


76026/ xxxxxx 5000 <LF> 


The system deposits the value you just typed (5000) and displays the 
next memory location: 


76030/ 


5. Type the contents of the next memory location followed by a line feed. 
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Repeat step 5 until you have deposited all the contents. Then press 


RETURN. | 
WY 


Finally, enable the processor (remove the halt condition) and type: 


76026G 


The processor reads the software bootstrap from the magtape into 
memory. The system prints the following prompt when it is finished: 


MSBOOT V05.0x 
* 
If the system does not print the MSBOOT prompt after you type 760266, 
you probably made an error in entering the bootstrap loader. Open and 
examine each location, using MICRO-ODT, and correct the error. 
Respond to the asterisk (*) by typing MDUP.MU: 
| 
*MDUP .MU <RET> WW 


Follow the instructions in Chapter 8 of the RT-11 Installation Guide. 


4.3.2 loading the TMSCP Bootstrap, Using the Switch Register 


Deposit the TMSCP bootstrap loader in memory as follows: 


A 


ae 


Place the bootable TK50 magtape in drive unit 0 and power-up the drive. Y 
Set the ENABLE/HALT switch on the processor to HALT. 


Set the first address from the table in Section 4.3.3 (76026) in the 
Switch register. 


Press the LOAD ADDR switch. 


Set the contents for the first address from the table (5000) in the a 
Switch register. 


Lift the DEP switch. 
The processor automatically advances to the next address. 


Set the contents for the next address from the table in the switch 
register. 


Lift the DEP switch. 


Repeat steps 7 and 8 until you have deposited all the instructions. 
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Now, verify that you properly deposited the bootstrap loader. 


i 
ae 


Once you 
follows: 


a 


rae 


Set the starting address, 76026, in the switch register. 
Press the LOAD ADDR switch. 


Press the EXAM switch to display the contents of that address in the 
data register. 


Compare the value in the data register with the contents value for that 
address in Section 4.3.3. 


If the values are the same, press EXAM again to display the contents of 
the next address. If the values are not the same, correct the contents 
value and lift the DEP switch. Press EXAM again to display the 
contents. Verify the contents of all addresses in this way. 


have correctly deposited the bootstrap in memory, start the computer as 


Set the starting address, 76026, in the switch register. 
Press the LOAD ADDR switch. 

Set the ENABLE/HALT switch to ENABLE. 

Press the START switch. 


The processor reads the software bootstrap from the magtape into 
memory. The system prints the following prompt when it is finished: 


MSBOOT V05.0x 

* 
If the system does not print the MSBOOT prompt after you press the 
START switch, you probably made an error in entering the bootstrap 
loader. Repeat the procedure. 
Respond to the asterisk (*) by typing MDUP.MU: 

*MDUP .MU <RET> 


Follow the instructions in Chapter 8 of the R7J-11 Installation Guide. 


4.3.3 Addresses and Contents of the TMSCP Bootstrap Loader 


The following are the addresses and contents of the TMSCP bootstrap loader: 


Address Contents 


076026 5000 
076030 12701 
076032 174500 
076034 12704 


076036 76160 


as5 
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076040 12705 
076042 4000 | | 
076044 10102 YJ 
076046 12422 
076050 S712 
076052 100770 
076054 oL205 
076056 1774 
076060 12412 
076062 6305 
076064 100371 
076066 10502 
076070 5022 
076072 105702 
076074 L003 71S 
076076 10S 237 
076100 100077 
076102 iQszs7 
076104 100075 ) 
076106 10037 aw 
076110 100104 a 
076112 112437 
076114 100115 
076116 112437 
076120 100110 
076122 10522 
076124 10522 
076126 i2TZ2 
076130 100100 | 
076132 10512 - 
076134 24242 
076136 5714 
076140 S7LZ 
076142 100776 
076144 31S] 
076146 100012 
076150 Lod 
076152 105704 
076154 100344 
076156 5007 Ww 
076160 46525 
076162 100000 
076164 100200 
076166 0 
076170 1 
076172 4400 
076174 20476 
076176 20402 
4,4 MANUAL LOADING OF THE MSCP SOFTWARE BOOTSTRAP 
If your processor does not contain the correct DU boot ROM and you want to boot 
your processor from an MSCP device, you must manually load the MSCP software 
ww 
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bootstrap. You can load the MSCP software bootstrap, using MICRO-ODT or the 
console switch register if your processor has a console switch register. 


You can then manually install the software distribution as described in Chapter 
9 of the RT-11 Installation Guide. 


4.4.1 Loading the MSCP Bootstrap, Using MICRO-ODT 


Deposit the MSCP bootstrap loader in memory as follows: 


Ly 


Place the bootable MSCP volume in physical unit DUO: (the unit 
installed at DU CSRO) and power-up the drive. 


Turn on your processor; if it is already on, halt it. 


At the console, type the first address from the table in Section 4.4.3 
(76000) followed by a slash (/): 


76000/ 


The system responds by printing the contents of address 76000 
(represented below by xxxxxx) on the console: 


76000/ xxxxxx 


On the same line, type the first contents value from the table (5000) 
followed by a line feed: 


76000/ xxxxxx 5000 <LF> 


The system deposits the value you just typed (5000) and displays the 
next memory location: 


76002/ 
Type the contents of the next memory location followed by a line feed. 


Repeat step 5 until you have deposited all the contents. Then press 
RETURN. 


Finally, enable the processor (remove the halt condition) and type: 
76000G 

The processor reads the software bootstrap from the MSCP volume into 

memory. When it is finished, the system prints an RT-11 monitor 

identification message such as the following: 


RT11FB V05.0x 


If the system does not print an RT-11 monitor identification after you 
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type 76000G, you probably made an error in entering the bootstrap 
loader. Open and examine each location, using MICRO-ODT and correct 
the error. 


4.4.2 Loading the MSCP Bootstrap, Using the Switch Register 


Deposit the MSCP bootstrap loader in memory as follows: 


i 


Os 
7% 


Place the bootable MSCP volume in physical unit DUO: (the unit 
installed at DU CSRO) and power-up the drive. 


Set the ENABLE/HALT switch on the processor to HALT. 


Set the first address from the table in Section 4.4.3 (76000) in the 
Switch register. 


Press the LOAD ADDR switch. 


Set the contents for the first address from the table (5000) in the 
Switch register. 


Lift the DEP switch. 
The processor automatically advances to the next address. 


Set the contents for the next address from the table in the switch 
register. 


Lift the DEP switch. 


Repeat steps 7 and 8 until you have deposited all the instructions. 


Now, verify that you properly deposited the bootstrap loader. 


Ls 


Z% 


Once you 
follows: 


bs 


Set the starting address, 76000, in the switch register. 
Press the LOAD ADDR switch. 


Press the EXAM switch to display the contents of that address in the 
data register. 


Compare the value in the data register with the contents value for that 
address in Section 4.4.3. 


If the values are the same, press EXAM again to display the contents of 
the next address. If the values are not the same, correct the contents 
value and lift the DEP switch. Press EXAM again to display the 
contents. Verify the contents of all addresses in this way. 


have correctly deposited the bootstrap in memory, start the computer as 


Set the starting address, 76000, in the switch register. 
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Press the LOAD ADDR switch. 

Set the ENABLE/HALT switch to ENABLE. 

Press the START switch. 

The processor reads the software bootstrap from the MSCP volume into 
memory. When it is finished, the system prints an RT-11 monitor 
identification message such as the following: 


RTI1IFB V05.0x 


If the system does not print an RT-11 monitor identification after you 


press 
bootstrap loader. 


Address Contents 
76000 5000 
76002 cb fink 
76004 172150 
76006 12704 
76010 76156 
76012 12705 
76014 4000 
76016 10102 
76020 10022 
76022 S71Z 
76024 100770 
76026 31205 
76030 401 
76032 42125 
76034 17 tZ 
76036 14412 
76040 6305 
76042 100367 
76044 105744 
76046 1002 
76050 10704 
76052 5007 
76054 5002 
76056 BUZZ 
76060 20227 
76062 17204 
76064 103774 
76066 L05z237 
76070 L712 
76072 10037 
76074 17110 
76076 111437 


the 


you probably made an error in entering the 
Repeat the procedure. 


4.4.3 Addresses and Contents of the MSCP Bootstrap Loader 


The following are the addresses and contents of the MSCP bootstrap loader: 
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76100 17114 
76102 114437 
76104 Lfizl 
76106 LZi2Zz 
76110 17004 
16432 10522 
76114 LZi2Z 
76116 17104 
76120 LOS ke 
76122 24242 
76124 ogee 
76126 sa pws 
76130 100776 
16132 SiS? 
76134 17016 
76136 1742 
76140 0 
76142 20402 
76144 4400 
76146 : 
76150 0 
76152 17204 
76154 100000 


4.5 PROCEDURES FOR LINE PRINTERS AND TERMINALS 


This section describes procedures you may need to follow to use your line 
printer or terminal. 


4.5.1 SETUP Modes and Controls for Line Printers 


The following sections list SETUP modes and controls for line printers supported 
by the SETUP utility. 


4.5.1.1 Uniform SETUP Mode and Control Support for Line Printers - The 
following SETUP modes and controls act in a uniform manner. That is, the action 
of the mode or control is consistent for all indicated line printers. A Yes in 
the table indicates support for the indicated mode or control. Dashes (---) 
indicate no support. 


Modes and 

Controls LA5O LA100* 1LA210* 4LG01 LGO2 1LJ250 LNO3 LQPO02 
[NO] BOLD Yes sala = = nea Yes Yes Yes 
CLEAR Yes Yes Yes << “<= Yes Yes Yes 
DOWN Yes Yes Yes crater Yes Yes Yes Yes 
GRAPHIC Yes Yes Yes ahaa <= <= = = 
HELP Yes Yes Yes Yes Yes Yes Yes Yes 
HORIZONTAL Yes Yes = Yes Yes Yes Yes ee 
LANDSCAPE -—= “<= “= --- Yes --- Yes --- 


a 
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Modes and 

Controls LA50 
LANG Yes 
PAGELENGTH Yes 
PORTRAIT --- 
RESET Yes 
[NO] TABS:n Yes 
TEXT Yes 
[NO] UNDERLINE Yes 
UP Yes 
VERTICAL Yes 
[NO] WRAP Yes 


LAi00* 


Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 


LA210* 


Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 
Yes 


LGO1 LG02 
Yes Yes 
-—— Yes 
Yes Yes 
= Yes 
Yes Yes 
= Yes 
Yes Yes 
=o Yes 


Yes 
Yes 
Yes 
Yes 
Yes 


LNO3 LOQPO2 
Yes mo 
Yes Yes 
Yes i i 
Yes Yes 
Yes Yes 
Yes ola 
Yes Yes 
Yes Yes 


* Set LA100 and LA210 printers to AUTO mode before issuing them SETUP 


commands. 


4.5.1.2  Nonuniform SETUP Mode and Control Support for Line Printers - The 
following SETUP modes and controls act in a manner specific to particular line 
printers. That is, the action of the mode or control depends on the particular 


line printer you are using. 


For the LA50, LA100, and LA210 printers: 


Modes and 
Controls 
DENSE 


DRAFT 


LETTER 


LISTING 


MEMO 


LA50 
Printer 


Normal 
Density 


Hor:10 


Normal 
Density, 
Hor: 16.5 


Enhanced 
Density 


LA100* 
Printer 


Letter Mode, 
High Density 


Draft 
Letter Mode, 
Medium 
Density, 
Hor:10 
Draft, 

sles apwl'a oes, 


Letter Mode, 


Medium Density 


Dashes (---) indicate no support. 


LA210* 
Printer 


Draft, 
Hor:16.5 


Letter Mode, 
Medium Density 


* Set LA100 and LA210 printers to AUTO mode before issuing them 


commands. 


SETUP 
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For the LG0O1, LG02, LJ250, LNO3, and LQPO2 printers: 


Modes and LGOl LGO2 LJ250 LNO3 LOP02 
Controls Printer Printer Printer Printer Printer 
DENSE --- oo --- --- --- 
DRAFT --- --- ~~ --- --- 
LETTER Hor:10 <= Hore0 Hor: 10 Hor:1.0 
LISTING = Horti6.5 -Borsl16.5. Hertlh.3 —Hexsi2: 
MEMO --- “<= --- --- --- 


4.5.2 Line Printer Handlers 


This section describes restrictions and workaround solutions for using line 
printers with RT-11. 


If output to some line printers is terminated prematurely, the print 
head may not be at the left margin. When output to the printer is 
resumed, printing may begin in the middle of the line. To prevent that, 
manually reset the printer. 


Some conditions cause data sent to a printer, using the LS handler, to 
be lost without warning. Those conditions are: 


For all terminals: the printer is powered down or placed off line. 


For all terminals except LA34, LA38, 1LA120, 4LS120, and _ serial 
LA180: The terminal encounters an error condition while in 
operation. 


The LS handler cannot be used to communicate with the console terminal. 
Instead, you must use the TT handler. 


The SET LS NOHANG option is valid only if device timeout support is 
included in a monitor created through system generation. However, 
DIGITAL recommends that you do not use the command SET LS NOHANG. That 
command can cause printers with very large buffers to cause the LS 
handler to abort an I/O request before they are through printing. 


If the LP or LS handler NOFORM or SKIP option is used, load the handler 
by including a LOAD command in your STARTx.COM files. Then, manually 
set the printer paper to top of page each time the system is 
bootstrapped (top of page is normally set so printing begins on the 
fourth print line down from the page perforation). Afterward, you 
should not manually move the paper. Instead, the handler should perform 
all movement of the paper. 


For example, to remove the last printed file from the printer, you must 
send two form feeds to the printer. Create the file FF.LST with an 
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editor and include in the file only two form-feed characters (CTRL/L). 
When you issue the command PRINT FF, the printer will perform two form 
feeds, so you can remove the last file printed. The top of page will 
still be set correctly for printing the next file. 


For the LS handler, the default CSR address is 176500 and the default 
vector address is 300. If your line printer is connected toa 
DL11/DLV11 interface with different addresses, use the SET LS CSR and 
SET LS VECTOR commands to modify the default values. For example, to 
modify the LS handler to use the MINC-11 printer port, SLU2, issue the 
following command: 


-SET LS CSR=176520, VECTOR=320 


You must then unload and load the LS handler for that command to take 


effect. 


4.5.3 Recommended Terminal/Line Printer SET Command Options 


This section lists the nondefault SET options recommended for use with 
terminals and line printers shown. 


LA50, LOP02 


SET 
LA100 


SET 
SET 


LA210 


SET 


LS TAB,CR, CTRL, FORM, NOFORMO, LC, WIDTH=n 


TT NOSCOPE, TAB, FORM, WIDTH=n 
LS TAB,CR, CTRL, FORM, NOFORMO, LC, WIDTH=n 


LS TAB, CR, CTRL, FORM, NOFORMO, LC, WIDTH=n 


LA30, LA35, LA36, and LS120 


SET 
SET 


LA34 and 


SET 
SET 


LA120 


SET 
SET 


LA180 
SET 


SET 


TT NOSCOPE, WIDTH=n 
LS CR, CTRL, NOFORM, NOFORMO, LC, WIDTH=n 


LA38 


TT NOSCOPE, TAB, WIDTH=n 
LS CR,CTRL, NOFORM, NOFORMO, LC, TAB, WIDTH=n 


TT NOSCOPE, FORM, TAB, WIDTH=n 
LS CR, CTRL, NOFORMO, LC, TAB, WIDTH=n 


LP CR,CTRL,NOFORMO, LC, WIDTH=n 


LS CR,CTRL, NOFORMO, LC, WIDTH=n 
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LGO1, LGO2, LJ250 

SET LP CR,LC, CTRL, FORM, NOFORMO 

SET LS CR, LC, CTRL, FORM, NOFORMO 
vtT05 

SET TT TAB, WIDTH=72 
vt50, VT52, VT55, and VT100 Series 

SET TTI NOCRLF, TAB 
SET TT commands are not permanent and must be issued every time the monitor is 
bootstrapped. Therefore, DIGITAL recommends that you include the command in the 
appropriate STARTx.COM file(s). However, SET LP and SET LS commands modify the 
permanent copy of the handler, so you need to issue them only once. 
When running under a multiterminal monitor, you can set the characteristics of 
local terminals other than the boot-time console: Include the command SET TT 
CONSOLE=n in an appropriate STARTx.COM file followed by the SET TT commands you 
want for that terminal. After all the terminal characteristics have been set, 
include the SET TT CONSOLE=0 command in the STARTx.COM file to return control to 
the boot-time console. 


Of the SET TT commands listed, only the SET TT SCOPE command is valid for a 
Single-terminal SJ monitor. 


4.5.4 Recommended VT100 Series, VT105, and LA120 Series Setup Mode Options 

This section lists recommended setup modes for VT100 series, VT105, and LA120 
series terminals. Terminal bauds should be set to correspond to the computer 
interface. Setup options other than those discussed below should be set for 
operator preference or form requirements. To permanently save the setup options 


you select, type <SHIFT/S> on a VT100 series or VT105 or <SHIFT/9> on an 1LA120 
series. 


4.5.4.1 V¥T100 Series and VT105 Terminals - The following setup mode options are 
recommended for normal use on VT100 series and VT105 terminals: 


On line 
Autorepeat on 


Margin bell off (when preparing FORTRAN programs, you may want to have the 
margin bell set on to notify you when column 72 is reached) 


Auto XON/XOFF on 
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Wrap around on 

New line off 
Interlace off 
Parity Off 

Bits per character 8 


Tabs set every 8 columns 


4.5.4.2 LA120 Series Terminals - LA120 series terminals should be initialized 
to factory settings. Then, buffer control should be changed to small. The 
following factory setup options should not normally be changed: 

Line/local status 

Local echo 

Auto newline 

Parity and data bits 

Auto repeat 

Auto linefeed 

XON/XOFF 


Printer new line character 


Use the LA120 local form-feed key to make sure that the paper is positioned 
correctly at top of form before printing a listing. 
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CHAPTER 5 


NATIVE TRANSFER UTILITY (TRANSFER) 


The native transfer utility (TRANSFER) is an unsupported program that runs on 
one of five host operating systems and copies files from an RT-11 stand-alone 
processor to the host processor and from the host to the stand-alone. TRANSFER 
is run only from the host processor and supports the following host operating 
systems: 


@® VAX/VMS 
@ MicroVMS 
e@ RSX-11M 


® RSX-11M-PLUS 
® Micro/RSX 


(In the rest of this chapter, VAX/VMS refers to VAX/VMS and MicroVMS, and RSX 
refers to RSX-11M, RSX-11M-PLUS, and Micro/RSX.) 


TRANSFER can copy files from Files-11 volumes (on VAX/VMS or RSX) to RT-11 
volumes. It can also perform transfers from files on RT-11 volumes to files on 
Files-1l1 volumes. Files-11 is the disk volume format maintained by the VAX/VMS 
and RSX operating systems. 


You can use command qualifiers to specify the format of the transferred output 
file. The supported formats are: 


@ ASCII 

@® Binary 
® FORTRAN 
@e Image 


In addition, you can use command qualifiers that cause TRANSFER to: 
e Supply additional information during the transfer operation 


@e Display HELP information 
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@ Operate in PROMPT mode, an interactive mode with questions and defaults 


® Queue the output file to the host system default printer (VAX/VMS host 
only) 


Before you can use TRANSFER, you must install the appropriate version on the 
host system. Two versions of TRANSFER are included on the RT-11 distribution 
kit. The program named TRANSF.EXE is the version that runs on VAX/VMS. The 
program named TRANSF.TSK is the version that runs on RSX. 
Once you have installed the appropriate utility program on the host processor 
(cunning VAX/VMS or RSX), use VICOM to establish a connection between the RT-11 
stand-alone processor and the host. You can use the TRANSFER utility only after 
you have established that connection. 
This chapter: 

@® Describes how to copy and install TRANSFER on the host processor 

@® Explains how to use TRANSFER 


@® Lists TRANSFER error messages 


5.1 INSTALLING TRANSFER ON THE HOST 


TRANSFER can be installed on the host processor as a system utility that is 
available to all system users or in an individual’s account. 


The host system manager must install TRANSFER if it is to be a_ system-wide 
UELLIey . 

To install TRANSFER in your own account on the host, perform the ‘procedures in 
Section 5.1.1 (VAX/VMS) or 5.1.2 (RSX). You must have a privileged account to 
install TRANSFER on an RSX host. If you do not have a privileged account on an 


RSX host, you must have the system manager install TRANSFER in your account. 
You do not need a privileged account to install TRANSFER on a VAX/VMS host. 


5.1.1 Installing TRANSFER On VAX/VMS 

Install TRANSFER on Version 4.0 or subsequent versions of VAX/VMS. 

Step 1: Copy TRANSF.EXE 

If you know that the VAX/VMS system is running RTEM, you can use TRANSF.SAV (a 
different transfer utility) under RTEM to copy TRANSF.EXE from the RT-11 
stand-alone processor to the host. Do not attempt that procedure unless you are 
familiar with RTEM. 


If the VAX/VMS system is not running RTEM, mount the RT-11 distribution volume 


o=2 
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on the host and issue the following VAX/VMS command to transfer TRANSF.EXE to 
the host. 


When you type the command, replace the variable ddcu: with the VAX/VMS physical 
device name for the device on which TRANSF.EXE resides. Type the command 
exactly as shown: 


$ EXCHANGE COPY/CONTIGUOUS ddcu: TRANSF .EXE/VOLUME FORMAT=RT11 TRANSFER.EXE 


NOTE 


Because TRANSF.EXE is not an ASCII file, you cannot use the 
VTCOM SEND command to copy TRANSF.EXE from the RT-11 stand-alone 
processor to the host. 


Step 2: Define TRANSFER As a Foreign Command 


The following command completes the installation of TRANSFER by defining it as a 
foreign command. (A foreign command is a symbol name, in this case TRANSFER, 
that you use to invoke the utility.) Placement of the asterisk (*) lets you 
abbreviate TRANSFER to TRA. 


When you type the following command, replace the variable disk with the name of 
the disk on which your VAX/VMS directory resides. Be sure to include the dollar 
Sign ($) before the variable disk. Replace the variable directory with the name 
of your VAX/VMS directory. 


$ TRA*NSFER :== S$disk: [directory] TRANSFER. EXE 


5.1.2 Installing TRANSFER on RSX 


Install TRANSFER on the indicated version or subsequent versions of the 
operating systems in the following list: 


@ RSX-11M-PLUS 3.0 
@® RSX-11M ae 
@e Micro/RSX 0 


The RMSRES resident library must be installed on any RSX operating system 
running TRANSFER. The DAPRES resident library must be installed, along with 
system DECnet support, to access files across DECnet. 


Use the following steps to install TRANSFER on RSX: 

step 1: Copy TRANSF.TSK 

If you know that the RSX system is running RTEM, you can use TRANSF.SAV (a 
different transfer utility) under RTEM to copy TRANSF.TSK from the RT-11 


stand-alone processor to the host. Do not attempt that procedure unless you are 
familiar with RTEM. 


saat, 
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If the RSX system is not running RTEM, mount the RT-11 distribution volume on 
the host and use the following RSX commands to transfer TRANSF.TSK to the host. 


When you type the commands, replace the variable ddn: with the RSX physical 
device name for the device on which TRANSF.TSK resides. 


> MOUNT /NOSHARE/FOREIGN ddn: 
>FLX SY:=ddn: TRANSF.TSK/CO/RT/IM 


>RENAME TRANSF.TSK TRANSFER.TSK 


NOTE 


Because TRANSF.TSK is not an ASCII file, you cannot use the 
VICOM SEND command to transfer TRANSF.TSK from the RT-1l 
stand-alone processor to the host. 


Step 2: Install the RSX Task Image 


Use the following command to install TRANSFER. You must have a privileged 
account to issue this command. If you do not have a privileged account, have 
your system manager install TRANSFER. 


>INSTALL TRANSFER. TSK 


5.2 USING TRANSFER 


TRANSFER can copy files between a PDP-11 processor running RT-11 and either a 
PDP-1l1 processor running RSX or a VAX processor running VAX/VMS. No 
intermediary (such as the RT-11 emulator, RTEM) is required. 


To use TRANSFER, make sure the appropriate version of the TRANSFER utility has 
been installed on the host processor (running VAX/VMS or RSX). Then use VICOM 
to establish a connection between the RT-11 stand-alone processor and the host. 
You can use the TRANSFER utility only after you have established that 
connection. If you run VICOM as a system job, you must LOAD all handlers for 
devices you are uSing with VTICOM. The RT-11 SHOW command displays information 
about devices. See the RT-11 System Utilities Manual for complete information 
on using VICOM. 


Run the TRANSFER utility by issuing the TRANSFER command in response to the host 
system’s prompt. 


You can abort a file transfer at any time and return to the host system’s prompt 
by typing CTRL/C. CTRL/C is the preferred method of aborting file transfers on 
RSX and VAX/VMS systems. You can also abort file transfers on VAX/VMS systems 
by typing CTRL/Y and then issuing the EXIT command in response to the monitor 
DIrOMmpt. 


You can exit from TRANSFER and return to the host system’s prompt by typing 
CTRL/Z in response to a TRANSFER prompt. 


yom, 
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5.2.1 TRANSFER Command Syntax 


The TRANSFER command has the following syntax: 


TRANSFER<SP>input-filespec 


Or: 


TRANSFER {/HELP} 


{ /PROMPT} 
{ /VERSION} 
Ors 
TRANSFER<RET> 


{/ASCII[:n] } [<SP>output-filespec 
{ /BINARY[:n] } 

{ /FORTRAN[:n] } 

{ /IMAGE[:n] } 


| {/ASCII[:n]}] 
! 

| /LOG 

| 

| 

| 

| 


{ /BINARY[:n] } 
{ /FORTRAN [:n} 
{ /IMAGE[:n] } 


/LOG 
/PROGRESS[:n] /PROGRESS[:n] 
{/REMOTE } {/REMOTE } 
{ / TERMINAL } { / TERMINAL} 
/STATISTICS /SPOOL 
/STATISTICS 


From: input-filespec[/qualifier[/qualifier...]] 
To:  output-filespec[/qualifier[/qualifier...]] 


where: 


input-filespec 


output-filespec 


is the input file specification of the file you want to 
copy. The file specification is operating system 
dependent. Consult your operating system documentation 
for the correct construction of the file specification. 
However, observe the following: 


@ Wildcards are not allowed in the file specification. 


e If you do not specify an output-filespec, the first 
Six characters of the input file name and the first 
three characters of the input file type (extension) 
must be alphanumeric. 


@ TRANSFER does not access files contained -within a 
virtual disk on the host. 


@ You cannot specify any host system record oriented 
device, such as a line printer, terminal, or magtape 
device. 


is the file specification of the file to which you want 


the file transferred. The file specification is 
operating system dependent. Consult your operating 
system documentation for the correct construction of 
the file specification. However, observe the 
following: 
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® Wildcards are not allowed in the file specification. 


@® RT-11 truncates input file names to six characters 
and input file types (extensions) to three 
characters. 


@® You cannot specify any host system record oriented 
device, such as a line printer, terminal, or magtape 


device. 
/qualifier is a TRANSFER qualifier. The two types of TRANSFER 
qualifiers are: Mode qualifiers that determine the 


format of the transferred file and control qualifiers 
that affect transfer file processing by providing 
information, by invoking interactive mode, or by 
queuing the output file to a printer. 


{ } indicates mutually exclusive qualifiers, which are 


mutually exclusive on the input or output-filespecs and 
must appear only once in the command. 


5.2.2 TRANSFER Default File Types 

TRANSFER recognizes certain file types. If you do not specify a mode qualifier, 
TRANSFER performs the transfer in the default mode for that file type. TRANSFER 
recognizes the following file types as being ASCII or Binary: 


ASCII (variable-length records) 


.ANS . BAK . BAS «BAT mee Ft .B16 .B2S B32 ck 

my 4 8 . CMD . COM «COR GEL .DAT . DBL . DDF «DIF 
.DIR . DMP DOC ,FOR FTN on glide . LOG list 
. MAC . MAP . MAR . MEM .ODL — .PAS ‘4 . RNO .R16 
Roe a) OLP SRC JfEG s LES Lae 


Binary (variable-length records) 
.BIN LDA .OBU <5 


IMAGE mode is TRANSFER’s default transfer mode. If you do not specify the 
/ASCII, /BINARY, /FORTRAN, or /IMAGE qualifier and if the file you specify does 
not have a recognized file type, TRANSFER performs the transfer operation in 
IMAGE mode with 512-byte fixed-length records. 


5.2.3 TRANSFER Mode Qualifiers 


TRANSFER has four mode qualifiers that specify each type of supported file 
format. Format conversions can be in either direction between Files-11 volumes 
and RT-11 volumes. Only one transfer mode qualifier can be specified in a 
command. 
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/ASCII[ :n] 


This qualifier formats the output file as ASCII. On an RT-11 output volume, the 
file contains ASCII data records, each terminated by a carriage return/line 
feed, escape, form feed, or vertical tab. TRANSFER removes rubouts, nulls, and 
vertical tabs from input records and adds carriage return/line-feed pairs to the 
end of records that do not end with escape, form feed, or line feed. When the 
host input file record attributes do not specify carriage control, TRANSFER 
assumes embedded carriage control. Embedded carriage control means that each 
record contains the control characters necessary for proper formatting. In that 
case, carriage return/line feed pairs are not appended to records. 


In transfers from RT-11 to Files-11 volumes, TRANSFER removes carriage 
return/line-feed pairs from the end of records. 


If you specify a size value (:n), TRANSFER generates fixed-length records of 
that size and pads them with nulls if required. If you omit the size value (or 
specify a size of zero), TRANSFER generates variable-length records. 


/BINARY [ :n] 


Use the /BINARY qualifier to format the output file as binary. TRANSFER adds 
formatted binary headers and checksums to records that it copies to RT-11 files 
and removes binary headers and checksums from records that it copies to Files-11 
files. 


When you transfer files to Files-11 volumes, TRANSFER generates fixed-length 
records of the size (:n) you specify. If you omit the size value (or specify a 
Size of zero), TRANSFER generates variable-length records. 


/FORTRAN[ :n] 


The /FORTRAN qualifier transfers files that contain FORTRAN carriage control 
characters. Use the /FORTRAN qualifier when the first character of each record 
is to be interpreted as the carriage control specifier. The /FORTRAN qualifier 
does not alter any record data. Use this qualifier only when the output volume 
is a Files-11 volume. 


TRANSFER generates fixed-length records of the size (:n) you specify. if you 
omit the size value (or specify a size of zero), TRANSFER generates 
variable-length records. 


/IMAGE[:n] 
Use the /IMAGE qualifier to transfer files without performing any record 


translations on them. In other words, TRANSFER copies the files exactly as they 
are. 
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When you transfer files to Files-1l1 volumes, TRANSFER generates fixed-length 
records of the size (:n) you specify. If you omit the size value (or specify a 
size of zero), TRANSFER generates fixed-length records of 512 bytes. 


5.2.4 ‘TRANSFER Control Qualifiers 


TRANSFER provides the following qualifiers to control transfer processing: 


/ HELP 


The /HELP qualifier displays limited information about TRANSFER. The /HELP 
qualifier lists default TRANSFER formats for various file types. 


/LOG 


The /LOG qualifier creates a log of the names of all files transferred. The log 
displays a success message, the complete input and output filespecs, and the 
number of blocks or records transferred. For example: 


S TRANSFER FOO. TXT/LOG FOO. TXT 
STRANSFER-S-COPIED, USER: [RTINDEX] FOO. TXT; 2 copied to _ BEBUs DR FOO. TAE 
(6 blocks) 


/PROGRESS[:n] 


The /PROGRESS qualifier causes TRANSFER to display the progress of the transfer 
at specific intervals, while the operation is taking place. Progress is 
displayed in record or block intervals, depending on the format of the file and 
the direction of the transfer. You can specify the interval (:n). The default 
PROGRESS report interval is 10(decimal) records or blocks. 


The /PROGRESS qualifier displays an informational message, the time-of-day, the 
blocks or records transferred during that interval, the number of retries, and 
the packet size. An increase in the number of retries and a decrease in the 
packet size generally indicate interference on the transmission line. If the 
packet size decreases to an unacceptable level, retry the transfer operation 
when your transmission line might be more clear. 


An example of the /PROGRESS qualifier: 


$§ TRANSFER FOO.TXT/PROGRESS:1 FOO.TXT 


STRANSFER-I-PROGRESS, 14:33:25 blocks transferred=1 retries=0 packet_size=512 
STRANSFER-I-PROGRESS, 14:33:27 blocks transferred=zZ retries=0 packet size=512 


/PROMPT 


The /PROMPT qualifier causes TRANSFER to operate in an interactive mode that 
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displays questions, indicates defaults, and accepts input. The questions and 
defaults change dynamically, based on the responses to earlier questions. 
PROMPT mode shows a list of available responses in parentheses. The default 
response appears in brackets. To choose the default response, press the return 
key <RET>. Choose the default unless you are sure that another qualifier is 
COLTEecc. 


The following are sample PROMPT mode sessions. 


The following example copies the ASCII file V5NOTE.TXT from the RT-11 
stand-alone system to the host, keeping the same file name. Defaults are taken 
for the file format and host file record length. 


$ TRANSFER/PROMPT 

Original file is on (HOST,REMOTE) [HOST]: remote<RET> 

Name of original REMOTE file to copy: voSnote.txt<RET> 

Name of file to create on HOST [V5NOTE.TXT]: <RET> 

Create HOST file with (ASCII,BINARY,FORTRAN, IMAGE) records [ASCII]: <RET> 
Create HOST file with fixed-length records (YES,NO) [NO]: <RET> 
STRANSFER-S-COPIED, TTA2::DK:VSNOTE.TXT copied to USER: [RT11]V5NOTE.TXT 19 
(714 records) 

There were 0 retries, with 3362 characters saved through compression encoding. 


The following example copies the file VDT.OBJ from the host to an RT-11 
stand-alone system, keeping the same file name. Because VDT.OBJ is a binary 
file, the default BINARY qualifier is chosen. 


S TRANSFER/PROMPT 

Original file is on (HOST,REMOTE) [HOST]: <RET> 

Name of original HOST file to copy: vdt.obj<RET> 

Name of file to create on REMOTE [VDT.OBJ]: <RET> 

Create REMOTE file with (ASCII,BINARY,FORTRAN, IMAGE) records [BINARY]: <RET> 
STRANSFER-S-COPIED, USER: [WINNING] VDT.OBJ 1 copied to PTR2: :sDKRe VOTE 

(8 blocks) a 

There were 0 retries, with 276 characters saved through compression encoding. 


The following example copies the image file (executable program) VICOM.SAV from 
the RI-1ll system to the host, keeping the same file name. All defaults are 
taken. 


$ TRANSFER/PROMPT 

Original file is on (HOST,REMOTE) [HOST]: remote<RET> 

Name of original REMOTE file to copy: vtcom.sav<RET> 

Name of file to create on HOST [VTCOM.SAV]: <RET> 

Create HOST file with (ASCII,BINARY,FORTRAN, IMAGE) records [IMAGE]: <RET> 
Create HOST file with fixed-length records of size (0-512) <512>: <RET> 
STRANSFER-S-COPIED, | TTC2:DK:VICOM.SAV copied to USER: [RT11]VTCOM.SAV 2 

(24 blocks) 

There were 0 retries, with 5274 characters saved through compression encoding. 


/REMOTE 
/TERMINAL 
The /REMOTE and /TERMINAL qualifiers indicate to TRANSFER which file is on the 


RT-11 system. /REMOTE and /TERMINAL are interchangeable; they have the same 
meaning. Do not specify both qualifiers in the same command. 


ce, 
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To transfer a file from the host system to the stand-alone RT-11 system, use 
/REMOTE or /TERMINAL on the output-filespec. That operation is the default, so 
you can omit those qualifiers altogether from the command for this type of 
transfer. To transfer a file from the stand-alone RT-11 system to the host 
system, use /REMOTE or /TERMINAL on the input-filespec. 


The following example transfers the file FOO.TXT from the host to the 
stand-alone RT-11 system: 


$ TRANSFER FOO.TXT FOO.TXT 


The following example transfers the file FOO.TXT from the stand-alone RT-11 
system to the host: ? 


S TRANSFER FOO.TXT/TERMINAL FOO.TXT 


/SPOOL 

Use the /SPOOL qualifier to queue the TRANSFER output file to the default 
VAX/VMS system printer queue. Specify the /SPOOL qualifier on the host 
output-filespec. This qualifier is available only for VAX/VMS system transfers. 
/STATISTICS 

The /STATISTICS qualifier displays the number of retries and the number of 
characters saved through compression encoding. (Compression encoding is a 
transfer speed enhancement used by TRANSFER whether or not you specify the 
/STATISTICS qualifier.) For example: 

S$ TRANSFER FOO.TXT/STATISTICS FOO.TXT 

There were 0 retries, with 400 characters saved through compression encoding. 


/VERSION 


The /VERSION qualifier displays the TRANSFER utility’s version number. 


5.3 TRANSFER UTILITY MESSAGES 


This section describes the messages that can be returned by the TRANSFER 
By al ae ; 


5.3.1 Utility Message Format 
The messages displayed by the TRANSFER utility have the following format: 


SFACILITY-L-IDENT, TEXT 
[-FACILITY-L-IDENT, TEXT! 
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where: 
re 
FACILITY is the TRANSFER utility or operating system facility 
or component name. A percent sign (%) prefixes the 
first message issued, and a hyphen (-) prefixes each 

subsequent message. 


L is the severity level indicator, which has one of the 
following values: 


Code Meaning 


Success 

Information 

Warning 

Error 

Fatal or severe error 


WY SHW 


"" Consult your host operating system documentation for 
the meaning of each severity level. 


IDENT is the abbreviation of the message text; the messages 
below are alphabetized by this abbreviation. 


TEXT is the explanation of the message. 


[-FACILITY-L-IDENT, TEXT] is the next message. 


5.3.2 Messages Returned by TRANSFER 
The following is an alphabetical listing of the abbreviation (IDENT) and text 
for messages that can be returned by TRANSFER. Included is an explanation of 
each message and the recommended action to be taken. Consult your host 
operating system documentation for messages not listed here. 
AMBIGQUAL, ambiguous qualifier in command 
Explanation The command qualifier abbreviation contains too few 
characters to make it unique. Another qualifier begins 
with the same characters. 
User action Retype the command, using at least four characters of 
the qualifier name. 


CHKSUMERR, binary record checksum error 


Explanation The checksum for a BINARY record was in error. 


a a at 


User action 
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Make sure the input file is not an object library. 
Object libraries must be copied in IMAGE mode rather 
than BINARY mode. 


Make sure the input file is a valid binary file. Retry 
the transfer. 


CLOSEIN, error closing ’input-file’ as input 


Explanation 


User action 


RMS encountered an error while closing the indicated 
input file. This message is usually accompanied by an 
RMS message indicating the reason for the failure. 


Take corrective action based on the associated message. 


CLOSEOUT, error closing ’output-file’ as output 


Explanation 


User action 


RMS encountered an error while closing the indicated 
output file. This message is usually accompanied by an 
RMS message indicating the reason for the failure. 


Take corrective action based on the associated message. 


CONFQUAL, conflicting qualifier in command 


Explanation 


User action 


You specified qualifiers that are mutually exclusive. 
For example, you can specify only one TRANSFER mode 
qualifier (/ASCII, /BINARY, /FORTRAN, or /IMAGE) in a 
command. Also, you can specify /REMOTE or /TERMINAL on 
only one side of a command. 


Correct the qualifiers and retry the operation. 


FILSYNTAXERR, error in file specification 


Explanation 


User action 


You specified a file containing syntax that was invalid 
for the RT-11 system. For example, the file name might 
contain more than six characters. 


Correct the syntax of the file specification for the 
RT-1il system. 


ILLBINFORMAT, illegal binary record format 


Explanation 


You attempted to transfer a file from the RT-11 system 
to the host system, using the /BINARY format qualifier. 
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The file either was not a binary file or was a binary 
file with a bad format. 


User action Make sure the specified record format qualifier agrees 
with the actual file record format. Retry the 
operation. 


INVCMDSYNTAX, invalid command syntax 
Explanation The TRANSFER utility command contained invalid syntax. 


User action Correct the syntax and reenter the command. 


INVINPUTQUAL, invalid input qualifier /’ qualifier’ 


Explanation The indicated input qualifier is invalid in the 
command. 
User action Correct the qualifier and reenter the command. 


INVQUAL, invalid qualifier /’ qualifier’ 
Explanation The indicated qualifier is invalid in the command. 


User action Correct the qualifier and reenter the command. 


INVQUALVAL, invalid value for /’qualifier’ qualifier 


Explanation You specified an invalid value for the indicated 
qualifier. 

User action Check the range of valid values for that qualifier. 
Correct the value for the qualifier and reenter the 
command. 


NOVTCOM, VTCOM not running on remote 


Explanation VTCOM is not running on your RT-11 stand-alone system, 
or the host system response time is slow due to heavy 
usage. TRANSFER timed out before receiving a response 
from VTICOM. 


User action Make sure VTICOM is running on the RT-11 system. 
Decrease the load on the host system or lower the baud 
rate between the RT-11 stand-alone system and the host. 
Retry the operation. 
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OPENIN, error opening ’input~-file’ as input 


Explanation 


User action 


The indicated input file cannot be opened. fThis 
message is usually accompanied by an RMS message 
indicating the reason for the failure. 


Take corrective action based on the associated message. 


OPENOUT, error opening ’output-file’ as output 


Explanation 


User action 


The indicated output file cannot be opened. This 
message is usually accompanied by an RMS message 
indicating the reason for the failure. 


Take corrective action based on the associated message. 


QUOTNOOUTPUT, quoted string specification as input needs output specification 


Explanation 


User action 


You did not specify the output (RT-11 only) file, when 
the input (RMS) file was a quoted string specification. 


Explicitly specify the output file, when the input file 
is a quoted string specification. 


READERR, error reading ’input-file’ 


Explanation 


User action 


The indicated input file cannot be read. This message 
is usually accompanied by an RMS message indicating the 
reason for the failure. 


Take corrective action based on the associated message. 


REMABORT, file transfer aborted by remote 


Explanation 


User action 


The file transfer was aborted due to an I/O error on 
the RT-1l system, or the VICOM RESET command was 
issued. 


Check the procedures listed in Section 2 of the RT-11 
System Message Manual for recovery from hard error 
conditions. 


REMACCESS, error accessing remote 


Explanation 


A hard error occurred on the host system during a file 
transfer. 
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User action Retry the operation after performing hard error 
recovery procedures on the host system. 


REMCLOSEIN, error closing ’input-file’ as input on remote 
Explanation TRANSFER encountered an error while closing’ the 
indicated input file on the RT-11 system. This message 
1s usually accompanied by another message indicating 
the reason for the failure. 


User action Take corrective action based on the associated message. 


REMCLOSEOUT, error closing ’output-file’ as output on remote 
Explanation TRANSFER encountered an error while closing the 
indicated output file on the RT-11 system. This 
message is usually accompanied by another message 
indicating the reason for the failure. 


User action Take corrective action based on the associated message. 


REMOPENIN, error opening ’input-file’ as input on remote 
Expianation TRANSFER cannot open the indicated file on the RT-11 
system. This message is usually accompanied by another 
message indicating the reason for the failure. 


User action Take corrective action based on the associated message. 


REMOPENOUT, error opening ’output-file’ as output on remote 
Explanation TRANSFER cannot open the indicated output file on the 
RT-11 system. This message is usually accompanied by 
another message indicating the reason for the failure. 


User action Take corrective action based on the associated message. 


REMREADERR, error reading ‘input-file’ on remote 
Explanation TRANSFER cannot read the indicated input file on the 


RT-11 system. This message is usually accompanied by 
another message indicating the reason for the failure. 


Oe Lo 


NATIVE TRANSFER UTILITY (TRANSFER) 


User action Take corrective action based on the associated message. 


WY 


REMTIMEOUT, remote timed out during file transfer 
Explanation TRANSFER timed out during a file transfer. 


User action Make sure VICOM is running. Retry the operation. 


REMWRITEERR, error writing ’output-file’ on remote 


Explanation TRANSFER encountered an error while writing the 
indicated file on the RT-11 system. This message is 
usually accompanied by another message indicating the 
reason for the failure. 


User action Take corrective action based on the associated message. 
\ 
SENSEMODE, couldn’t read terminal characteristics 
Explanation TRANSFER could not read the terminal hardware 
characteristics required for a file transfer operation. 
User action Retry the operation after performing hard error 
recovery procedures on the host system. 
SETMODE, couldn’t write terminal characteristics WY 
Explanation TRANSFER could not set the terminal hardware 
characteristics required for a file transfer operation. 
User action Retry the operation after performing hard error 
recovery procedures on the host system. 
TERMINIT, error initializing terminal for 1/0  / 


Explanation TRANSFER could not initialize the terminal hardware on 
the host system for a file transfer operation. 


User action Retry the operation after performing hard error 
recovery procedures on the host system. 
TOOBILG, record too largs tor file's 1/0 buffer 


Explanation You attempted to transfer a Files-11l record that was 
too large for TRANSFER’s file buffer. 


User action 
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Make sure you are transferring a file in the correct 
mode or transfer the file in IMAGE mode. 


TOOLONG, ‘nn’ byte record exceeds output file’s maximum record length 


Explanation 


User action 


You specified a record length that was too small to 
hold the largest record from the RT-11 file. 


Specify a record length large enough to hold the 
largest record from the RT-11 file or transfer the 
file, using variable-length records. 


USERABORT, file transfer aborted by user 


Explanation 


User action 


You aborted the file transfer by typing CTRL/C, or an 
I/O error occurred on the host system. 


If an I/O error occurred, perform hard error recovery 
procedures on the host system. Retry the operation. 


WRITEERR, error writing ’output-file’ 


Explanation 


User action 


RMS encountered an error while writing the indicated 
file. This message is usually accompanied by another 
message indicating the reason for the failure. 


Take corrective action based on the associated message. 


a ae! a 


APPENDIX A 


V5.3 AND V5.4 ERROR MESSAGES 


A.1 V5.4 ERROR MESSAGES 


The following error messages are new for RT-11 V5.4. 


?BUP-E-Directory input error <dev:> 


BUP detected a hardware problem 


with the input device. For 
example, you inserted a floppy 
diskette incorrectly or your 


magtape device is off line. 


2?BUP-W-Bad block read at <nnnnnn> 


A bad block was detected at block 
number <nnnnnn> during a backup 
or restore operation. The 
corresponding block on the backup 
volume may contain invalid data. 


2BUP-W-Directory output error DEV: 


On a backup operation to magtape, 
BUP could not successfully write 
the volume header or volume ID 
label to the magtape. 


Correct your hardware problem and 
respond YES to the BUP prompt. 


During restoration, check the 
validity of the data in block n. 


Check if output volume is write 
protected. If write protected, 
remove write protection. If not 
write protected, mount another 
magtape and retry the operation. 


2DUP-E-—Output device is smaller than input device 


2DUP-E-Output device is truncated 


You issued a COPY/DEVICE/NOQUERY 
command, and the output device is 
smaller than the input device. 
The operation completes, but 
input data is truncated (lost) on 
the output device. 


Mount an output device large 
enough to receive all the data 
from the input device. 
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?DUP-E-Output device is smaller than input file 


?DUP-E-Output device is truncated 


You issued the command 
COPY/DEVICE/FILES/NOQUERY, and 
the output device is smaller than 
the input file. The operation 
completes, but input data is 
truncated (lost) on the output 
device. 


Mount an output device large 
enough to receive all the data 
from the input file. 


2DUP-E-Output file is smaller than input device 


2DUP-E-Output file is truncated 


You issued the command 
COPY/DEVICE/FILES/NOQUERY, and 
the output file is not large 
enough to receive the entire 
input device. The operation 
completes, but input data is 
truncated (lost) on the output 
Eile. 


2DUP-W-Output device is larger than 


You issued a COPY/DEVICE/NOQUERY 
command, and the output device is 
larger than the input device. The 
operation completed. 


2DUP-W-Output device is larger than 


You issued the command 
COPY /DEVICE/FILES/NOQUERY, and 
the device containing the output 
file is larger than the input 
file. The operation completed. 


?LD-W-Device not installed <DEV:> 


You attempted to access a logical 
disk mounted on a device that is 
not installed. 


Perform a SQUEEZE operation to 
consolidate all available free 
Space on the output volume. If 
the SQUEEZE operation does not 
produce enough free space, mount 
another output volume with enough 
free space to contain the entire 
input device. 


input device 


The number of blocks you can 
address on the output device is 
reduced, because the  /DEVICE 
option copies the home and 
directory blocks from the input 
device to the output device. 


input file 


The number of blocks you can 
address on the output device is 
reduced, because the /DEVICE 
option copies the home and 
directory blocks from the input 
device to the output device 
containing the output file. 


This iS a warning message. 
Install the device on which the 
logical disk is mounted. 
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2MDUP-F-Insufficient memory, bypassing automatic installation 


You attempted to perform the 
automatic installation (AT) 
procedure on a processor that 
does not contain enough memory to 
Support AI with this media. 


installation 
and the 


The automatic 

procedure stopped, 
procedure to manually install 
your media has begun. The 
asterisk prompt (*) you see on 
your terminal screen is from 
MDUP.MU; that is, MDUP.MU is now 
loaded in memory. See Chapter 8 
of the R7I-11 Installation Guide 
for complete information on 
manually installing your media. 


?PIP-F-Directory I/O error<dev:filnam.typ> 


The PIP utility experienced an 


I/O error when accessing the 
directory for the indicated 
volume. 


The I/O error is caused by a 
write-protected output volume or 
a corrupted directory structure 
on the input or output volume. 
Check if the output volume is 
write protected. If it is, remove 


the write protection. If the 
output volume is not write 
protected, attempt to recover 


data on the volume with the 
corrupted directory, using the 
methods described in Chapter 9 of 
the RIT-1l Software Support 
Manual. 


?SYSGEN-E-Ethernet handler support available for XM only 


You requested support for an 
Ethernet handler (NC, NO, or NU) 
while performing a SYSGEN for a 
monitor other than XM. 


2VTCOM-F-Clock not running 


You attempted to start VICOM on a 
processor that does not have a 
running system clock. 


You can request Ethernet handler 
support only when performing a 
SYSGEN to create an XM monitor. 
If you require Ethernet support 
then SYSGEN for an XM monitor or 
use the distributed XM monitor. 


Enable the system clock on your 
processor and restart VTCOM. 
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A.2 V5.3 ERROR MESSAGES 


The following error messages are new for RT-11 V5.3. 


?BA-F-Must type ’R BATCH’,type ’/U’ 


An UNLOAD BA command was’ entered 
before the handler was unlinked. 


Run BATCH and specify the /U 
option to unlink the handler. 
BATCH automatically performs the 
UNLOAD BA command. 


?BUP-F-Too many mismatches during verify operation 


The BUP verification procedure 
encountered an unacceptably high 
number of mismatches between the 
input and output data. 


?BUP-W-Bad buffer read 


BUP encountered a bad block on 
the tape during a restoration 
from tape to disk. 


?BUP-W-Verification error at n 


The BUP verification procedure 
encountered a mismatch between 
the input and output data at 
block n of the input device. 


In most cases, the mismatches are 
caused by bad blocks on the input 
device. If this error occurs, 
check the input device for bad 
blocks. By default, BUP returns 
this error if it finds more than 
25 decimal mismatches. To change 
this number, perform the 
customization patch procedure 
described in Section 2.8. 


When BUP returns this error, it 
copies the rest of the data in 
its buffer to the disk. Check the 
validity of the data on the disk. 
It may not be what you want. 


This error is usually caused by a 
bad block located near block n. 
Check the output data. It may not 
be what you expect. 


2?SL-F-SL cannot be unloaded while running 


You attempted to UNLOAD the SL 
handler while SL was running. 


Enter the command SET SL OFF, and 
then UNLOAD the SL handler. 
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V5.3 AND V5.4 ERROR MESSAGES 


?SYSGEN-F-Next default CSR address out of range 


SYSGEN calculated that the next 
default CSR address is out of 
range. 


SYSGEN determines the default CSR 
address from the previous CSR 
address you entered. Because the 
next default is out of range, 
SYSGEN asks the questions again 
(restarts the query sequence) for 
that device. 


2?SYSGEN-F-Next default VECTOR out of range 


SYSGEN calculated that the next 
default VECTOR address is out of 
range. 


2?SYSGEN-W-Address not even 


SYSGEN encountered an odd number 
for a CSR or VECTOR address. 


SYSGEN determines the default 
VECTOR address from the previous 
VECTOR address you~ entered. 
Because the next default is out 
of range, SYSGEN asks you the 
questions again (restarts the 
query sequence) for that device. 


SYSGEN will ask for the CSR or 
VECTOR address again. Enter an 
even number. 
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SOFTWARE PERFORMANCE REPORT (SPR) GUIDELINES 


Each new installation is provided with Software Performance Report (SPR) forms. 
The SPR form lets you report problems with, or suggest enhancements to, DIGITAL 
software and documentation. If you encounter a problem, complete an SPR and 
mail it to the local SPR center (see the inside back cover of the SPR form). 


DIGITAL responds to the name and address that you indicate on the form. You can 
obtain additional SPR forms by writing to the local SPR center. SPR response is 
provided at no charge for 90 days after installation and can be continued by 
subscription thereafter. 


DIGITAL requests that you include the following information in all SPRs: 
e The CPU type. 
@e The system device type and the unit on which it was mounted. 
e The amount and type of memory. 


® The configuration of the system at the time of the problem. Determine 
the configuration by using the SHOW ALL monitor command. If your 
configuration includes a hard-copy terminal, send a listing created by 
the command SHOW ALL. If your configuration does not include a 
hard-copy terminal, issue the SHOW ALL command, then write down and 
Submit any information from the report that seems relevant to the 
problem. 


@e The release and version numbers of all RT-11 image programs that you 
think are involved with the problem. Use the RESORC utility, with the 
new /V option, to determine the release and version numbers in the 
following manner: 


-RESORC filespec/V <RET> 
where filespec is an image program from Version 5.1 or later. 
The new RESORC /V option does not report release and version numbers for 


ASCII or .OBJ programs, but only for image programs such as those with 
Pole types .SAV, REL, and .Sxs. 
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RESORC prints a single-line report on your terminal. Repeat the command 
for each RT-11 image program. Write down the report for each program 
and submit the reports with your SPR. 


@e If the RT-11 monitor was created using the SYSGEN process, submit the 
link map and answer (.ANS) file produced by SYSGEN. 


e If possible, submit a machine-readable copy of your monitor, your 

utilities, test files, programs, or command streams that can be used to 
reproduce the problem. Preferred media are diskettes. Request that the 
media be returned if you want it back. 
If the problem requiring an SPR involves a program that is not part of 
the RT-11 distribution, send media containing the program. The program 
should contain comments. MACRO-11 and FORTRAN programs should use the 
standard RT-11 programmed requests and SYSLIB routines, as appropriate. 

@® If the problem resulted in a system halt, include with the SPR: 

The display given by the SHOW MEM command 
The contents of the general registers at the time of halt 
The top 16 words of the stack 


The contents of memory locations around the halt or the error 
location 


The contents of low memory locations 44 through 56 

The contents of the processor status word 

Any other system information that may relate to the problem 
If your configuration includes hardware from a vendor other than DIGITAL, 
include a description of the hardware and where it is located in your 


configuration. 


Any additional information you think may be relevant. A clear and 
precise SPR can expedite the response. 
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USING THE VIRTUAL MEMORY (VM) DEVICE AS THE SYSTEM DEVICE 


This appendix shows how to create and use a virtual memory (VM) device as your 
system (SY) device. All currently sold PDP-11 and Professional 300 series 
computers are capable of supporting a VM device. You use the VM region in the 
extended memory in your computer to create a VM device. If your computer 
hardware is capable of supporting a VM device, you can realize obvious gains in 
computer speed by running RT-11 from such a device. 

This appendix is divided into the following sections: 


® Computer hardware requirements for supporting a VM device as the system 
device 


® The advantages in creating and using a VM system device 

@e Configuring a VM device in your computer’s extended memory 
@e Determining a working system 

@e Creating a model working system 

@ Running RT-11 from a VM device 

® Creating other working systems for the VM device 


You can use the on-line index utility, INDEX, and the on-line help utility, 
HELP, to find more information on topics described in this appendix. 


C.1 COMPUTER HARDWARE REQUIREMENTS 

Your computer must contain at least 512K-bytes of memory and a Memory Management 
Unit for you to use VM as your system (SY) device. All current and most recent 
PDP-11 and Professional 300 series computers meet those requirements. 


Issue the following command to determine how much memory your computer contains. 
Let the display produced by the command scroll to the end. 


.SHOW CONFIGURATION <RET> 
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The information you are looking for is contained in the next-to-last block of 
lines: 


The second line of that block reads nnnnKB of Memory, where nnnn is_ the 
memory in bytes contained in your computer. The number displayed should be 
at least 512, and more is better. If the number displayed is less than 
512, you probably cannot create a VM device and should disregard the rest 
of this appendix. 


In the same block of lines you should also see displayed a line reading 
Memory Management Unit. If that line is not displayed, you cannot create a 
VM device and should disregard the rest of this appendix. 


C.2 THE VM DEVICE 


The VM device is an area in extended memory you configure as a disk. Once you 
configure VM as a disk, you copy a working RT-11 operating system to VM and boot 
VM. You are then running your computer from the memory contained in your 
computer. You can also often copy application programs you run into VM and run 
those programs from VM. 


When you run your computer from a physical disk, your computer periodically must 
read and write operating system code between the computer’s memory and that 
physical disk. When you run your computer from VM, your computer reads. and 
writes operating system code between segments of memory, which is much faster. 
When you copy application programs into VM and run them from VM, those 
application programs also run much faster, especially if they contain low-memory 
overlays. 


CAUTION 


The VM device uses extended virtual memory as a disk; that is 
what gives VM its speed. VM uses volatile memory for data 
storage, which is not permanent. Any files on your VM device 
can be destroyed when you hard boot your system or if power is 
disrupted to your system. Therefore, a good practice is to copy 
only RT-11 files or your programs to VM. . Create and edit files 
and data on permanent media, such as your hard disk. 


The following sections describe how you can configure and use a VM system device 
and realize the increase in computer speed. 


C.3 CONFIGURING A VM DEVICE 
How you configure your VM device is determined by which RT-11 monitor you are 


going to run from VM. The three RT-11 monitors available are SJ, FB, and XM. 
Any of the three can be run from VM. 
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C.3.1 Configuring a VM Device for the SJ or FB Monitor 

SJ and FB cannot access any extended memory other than that configured as _ VM. 
Therefore, if you intend to run SJ or FB from VM, you should configure VM for 
all extended memory. 


First determine if the VM device handler is installed on your system. Issue the 
following command and see if VM is listed in the display: 


.SHOW <RET> 

If VM is not listed in the display, issue the following command: 
-INSTALL VM <RET> 

Issue the following commands to assign all extended memory to VM: 
.SET VM SIZE=0 <RET> 
.UNLOAD VM <RET> 
~REMOVE VM <RET> 
~INSTALL VM <RET> 


Once you have configured VM, using the commands above, you can initialize VM and 
examine its directory to determine its size: 


.INITIALIZE/NOQUERY VM: <RET> 
~DIRECTORY VM: <RET> 


The number of free blocks indicated by the DIRECTORY command are available for 
your working system. You can now proceed to Section C.4. 


C.3.2 Configuring a VM Device for the XM Monitor 


This section assumes you are running the XM monitor. If you are not running the 
XM monitor, close any files you have open and issue the following commands: 


sCOPY/BOOT GY: RTILXM. SYS Si: <RKET> 
,BOUT 623 SBI 


The XM monitor automatically assigns a region in extended memory to VM. You can 
see that region by issuing the following command. Be ready to press the NO 
SCROLL or Hold Screen key to stop the display as it scrolls down your terminal 
screen. 


. SHOW MEMORY <RET> 


Once you have seen that VM occupies a region in extended memory, again press the 
NO SCROLL or Hold Screen key to let the display scroll to the end. 


You can determine the number of blocks available with the default VM region size 
by issuing the following commands: 


. INITIALIZE/NOQUERY VM: <RET> 
.DIRECTORY VM: <RET> 
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The size of the default VM device in blocks is determined by the amount of 
extended memory in your computer. Unless your computer contains significantly 
more than 512K-bytes of memory, you must lower the base address of the VM region 
in extended memory to enlarge VM sufficiently to create enough blocks to hold 
your working system. You should also leave enough extended memory to run any 
jobs that require it. Using the following values with a computer containing 
512K-bytes of memory will create a VM device of 686 blocks and leave 
approximately 50K-words of unused extended memory. That VM device is large 
enough to hold a functional working system and leaves enough unused extended 
memory to run at least KEX, VTCOM, and SPOOL as system jobs. 


Issue the following commands to modify the base address of the VM device to 
configure it for the characteristics described above: 


.SET VM SIZE=0Q <RET> 
.SET VM BASE=5000 <RET> 
~UNLOAD VM <RET> 
~REMOVE VM <RET> 
~-INSTALL VM <RET> 


Those commands set the size of the VM device to its default placement in memory; 
that is, from its base address to the top of available memory. Those commands 
also set the base address of VM at 500000(octal), and VM resides at that address 
when it is loaded in extended memory. 


Issue the following commands to initialize VM at its new size and examine its 
directory: 


. INITIALIZE/NOQUERY VM: <RET> 
~-DIRECTORY VM: <RET> 


C.4 DETERMINING YOUR WORKING SYSTEM 
The VM device is considerably smaller (contains far fewer blocks) than the 
physical disk you use as your system device. Therefore, you must be selective 
about what files you include in the working system you copy to VM. 
Your working system can be thought of as containing two types of files: 
mandatory files and optional files. The mandatory files are the minimum files 
required to run your computer. Optional files are those files you use to do 
your work; they can change as the nature of your work changes. 
Your working system must include at least the following mandatory files: 

@® SWAP.SYS 


6 The RI=-11 monitor ({RTLIGD .SYs, RITIFB.SYS, or BIIIXM.Sy35) 
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® The VM handler (VM.SYS for SJ or FB, or VMX.SYS for XM) 


® The disk device handler or handlers for your system, which include the 
device handler for your current system (SY) device and the default data 
(DK) device (those could be the same device handler). If you are using 
a Professional 300 series computer, you must also include PIX.SYS 


If you do not know the names of your system and default data device 
handlers, issue the following command to see which device handler is 
assigned SY and DK: 

HOW <RET> 


Throughout the rest of this appendix, ddn represents the disk device 
handler and unit number from which and to which you are copying files 


@ PIP.SAV 
@ DUP.SAV 
@ DIR.SAV 


Your working system also contains optional files. They include any utilities 
you typically use and any device handlers used by those utilities, along with. 
application programs. A useful exercise is to copy the required RT-11 files to 
your VM device and reexamine its directory. Note the number of free blocks. 
You can then better determine how many other utilities and device handlers VM 
will hold. 


The following section describes how to create a particular working system. You 
should create this working system as an example - you may also find it a useful 


working system. Section C.7 describes creating your own working systems. Other 
example working systems are shown with the procedure for creating them. 


C.5 CREATING A WORKING SYSTEM FOR THE VM DEVICE 


This section details the steps necessary to create a model working system. The 
model assumes a PDP-11 computer system with the following characteristics: 


e Contains 512K-bytes of memory 
® Is running under the XM monitor 


@ Is using ddn as the system (SY) and default data (DK) disk device 


handlers. (You should know your actual system and default data disk 
device handlers from the SHOW command you issued in the previous 
section) 


The model works for PDP-11 computers containing at least 512K-bytes of memory. 
The model also works for Professional 300 series computers so long as you make 
the necessary device handler substitutions (PIX.SYS, DWX.SYS, and D2ZxX.SY5 
instead of ddxX.SYS, and XCX.SYS instead of XLX.SYS). 
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The model contains the utilities KEX, RESORC, SETUP, SL, SPOOL, VBGEXE, and 
VTCOM. The model works as documented. DIGITAL recommends that you create and 
run the following VM working system as practice before you modify it (or create 
another) for your requirements. 


Perform the following steps to create a working system for VM (each step is 
described further in this section). 


1. Create a minimum functionality start-up command file (STARTX.COM) for 
the device your computer first boots. 


2. Create a start-up command file that configures your working system on 
VM. Name that file STARTV.COM. 


3. Create an indirect command file that initializes VM and copies your 
working system to VM. Name that file VM.COM. 


C.5.1 Create the Initial Start-up Command File (STARTX.COM) 


STARTX.COM is the file your computer uses when you first boot it. Assuming you 
will be running your computer from VM, you should edit the start-up file 
STARTX.COM for minimum functionality. The following procedure saves your 
current STARTX.COM file by copying it to a file named STARTX.DIS, so you will 
not destroy the contents of that file if you have already edited it and want to 
keep that edited file: 


1. Issue the following commands to save your current STARTX.COM file and 
to make another copy you will use in the following section: 


COPY SY ceTaRix.COM STARIX.OLS <RET> 
~COPY SY: STARTA.COM STARTY,COM <RET> 


2. Edit STARTX.COM to resemble the following example. The example assumes 
your hardware configuration includes a serial interface printer using 
the LS handler. 


ASS LS LP 
SET LS ENDPAG=1, NOFORMO 
RUN SETUP 
VT100, JUMP, LIGHT, CLEAR 


That example sets some printer and terminal characteristics. Those 
characteristics might not be the ones you use. Also, you may have to 
include others that set, for example, the CSR and vector addresses for 
your printer. You can set any printer and terminal characteristics you 
want. See the RT-11 System User’s Guide for an explanation of SET and 
SETUP commands. Include those commands you want. 


id 
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C.5.2 Create a VM Start-up file (STARTV.COM) 
You have already edited the start-up command file for the device your computer 
initially boots -- STARTX.COM. You must now create a start-up command file for 
the VM device -- STARTV.COM. 
VM runs the file STARTV.COM when you boot VM. Therefore, STARTV.COM should 
contain the start-up commands you normally use in your working system. This 
section includes a start-up command file suitable for this working system. 
You create STARTV.COM by using the following command: 

COPY STBRIY.COM STARTV.COM <RET> 
When editing STARTV.COM: 


® Be sure to delete the command INITIALIZE/NOQUERY VM: from STARTV.COM. 
Inclusion of that command destroys the contents of VM when you boot VM. 


A { 
| @ Your physical disk will no longer be your system device and therefore 
will no longer be automatically loaded. Any device used by a system job 
(such as KEX, VTICOM, or SPOOL) must be loaded. Be sure to LOAD your 
physical disk device handler if you are going to be using system jobs. 
@e You should ASSIGN a default data device (probably your physical disk). 
Provision for those points is made in the following example VM start-up command 
~ file. This file performs the following functions: 
ice’ 


@ Turns on the SL editor. 
® Runs VICOM as a system job. 


@ Loads dd. The symbol dd represents the handler for your default data 
device. 
e Assigns your default data device (ddn) as the SPOOL work file (SFD) 
> device. 


If you do not assign SFD to your default data device, SPOOL uses up to 
1000 blocks of VM for SFD. As a result, although a DIRECTORY command 
displays free blocks on VM, those free blocks are not available - they 
are assigned to SFD. 


@ Runs SPOOL as a system job. Flagpage support is disabled, and the 
spooler is set to adda form feed to the final page of each file you 
spool. 

e Sets terminal hardware characteristics. 


@ Assigns ddn as the default data device. 


@ Shows the memory listing and the date. 
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Use the KEX editor to open the file STARTV.COM and edit it to appear as 
or as you prefer: 


SET SL RECALL, KED, KMON 
f 

SRUN SY: VTCOM.SAV/PAUSE 
LOAD XL=VTCOM 

RESUME VICOM 

! 


LOAD dd 

ASS ddn SFD 

SRUN SPOOL/PAUSE 

SET SP FLAG=0, ENDPAG=1 
LOAD LS=SPOOL 

RESUME SPOOL 

ASS SPQ LP 

ASS SPO LPO 

ASS SPO LS 

ASS SPO LSO0 


SETUP VT100, JUMP, LIGHT, CLEAR 
ASS ddn DK 


SHOW MEMORY 
DATE 


C.5.3 Create VM.COM to Initialize and Set Up VM 


Use the KEX editor to create an indirect command file named VM.COM. 


follows 


VM. COM 


initializes the VM device and copies your working system to that device. The 
mandatory files for this working system are (ddX.SYS is required to communicate 


with disk device ddn): 


SWAP .SYS 
RT11XM.SYS 
VMX.SYS 
ddx.SYS 
PIP .SAV 
DUP .SAV 
DIR.SAV 


The optional files for this working system are: 


LDA.SYS 
LSX.SYS 
SLX.SYS 
SPX.SYS 
XLX.SYS 
KEX. SAV 
RESORC. SAV 
SETUP .SAV 
SPOOL. REL 
STARTV.COM 
VBGEXE. SAV 
VTCOM. SAV 
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The following indirect command file copies those system (.SYS) files and 
utilities to VM. In the following commands, ddn represents the physical device 
and unit number from which you are copying the files, and ddX represents your 
disk device handler. The last line copies the VM device start-up command file, 
STARTV.COM, to the VM device and renames it STARTX.COM, which lets VM find its 
Start-up command file when you boot VM. 


Use the KEX editor to create the file VM.COM. Enter the following commands in 
that file: 


SET VM SIZE=0 

SET VM BASE=5000 

UNLOAD VM 

REMOVE VM z 

INSTALL VM 

INIT/NOQ VM: 

COPY/SYS ddn:SWAP.SYS VM: 

COPY/SYS ddn:RT11XM.SYS VM: 

COPY /SYS ddn: (VMX, ddx, XIX, LSX) .SYS VM: 
COPY /SYS ddn:{LDX, SLX, SPX).SYS VM: 
COPY ddn: (DUP,DIR, PIP, KEX,RESORC, SETUP) .SAV VM: 
COPY ddn: (VBGEXE, VTCOM) .SAV VM: 

COPY ddn:SPOOL.REL VM: 

COPY ddn:STARTV.COM VM:STARTX.COM 
COPY/BOOT VM:RT11XM.SYS VM: 


Notice that the following commands, with various base address values, are 
included in all the command files that copy working systems to VM. 


SET VM SIZE=0 
SET VM BASE=5000 
UNLOAD VM 
REMOVE VM 
INSTALL VM 


Once you have changed the base address of VM, you must boot a VM with that base 


address. Therefore, the commands above should be included in the command files 
that copy working systems to VM to avoid any conflict in VM base addresses. 


C.6 RUNNING RT-11 FROM THE VM DEVICE 


This section assumes you have done the steps described in Sections C.5.1 through 
C.5.3. Use the following steps to run RT-11 from your VM device: 


1. If you are now running your computer, close any files you have open. 
Boot your computer: 


, BOOT SY: <RET> 


Your computer executes the commands contained in the start-up file 
STARTX.COM. 
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2. After your computer has booted, issue the following command: 
S@VM <RET> 


That command runs the indirect command file VM.COM. (The dollar sign 
(S$) ais recommended because VM.COM is an indirect command file and not 
an IND control file.) If VM.COM does not run to completion (execute all 
commands in the file), repeat steps 1 and 2. You may have previously 
assigned the size of the VM device (SET VM SIZE=nnnnn command) to some 
nonzero value, causing VM.COM to abort for any number of reasons. You 
should not have this problem again unless you assign the size of the VM 
device to some nonzero value at a later time. If you do that, you will 
have to repeat this correction. 


3. When you receive the monitor prompt (.), boot the VM device: 
BOOT VM: <RET> 
After you have booted VM, examine the directory: 
VLR bit <BEIS 


If your computer contains 512K-bytes of memory and the size of the VM 
directory is not 686 blocks (combined used and free blocks), you 
probably have some variation of the problem described in Step 2. 
Repeating steps 1, 2, and 3 should correct the problem. 


You are now running the XM monitor from your VM system device. Running your 
working system from VM is different than running from your hard disk in at least 
two ways: 


@ VM is faster than your hard disk. 


@e The system device is smaller and therefore contains fewer utilities. 
That difference is not normally a problem, as the device is large 
enough to contain the set of utilities you use when doing particular 
work, such as writing and editing or programming. If you do more than 
one type of work with your computer, you may want to create more than 
one working system for your VM device. See the following section for a 
discussion of multiple VM system devices. 


C.7 MULTIPLE WORKING SYSTEMS FOR THE VM DEVICE 


A working system containing the utilities KEX, VTICOM, and SPOOL would be 
appropriate for text editing, maintaining communications with a host computer, 
and so forth. That working system, however, would not be appropriate for 
writing and debugging programs. 


If you want to take advantage of the increased performance you attain by running 
RT-11 from the VM device and you perform more than one type of work with your 
computer, you should create multiple working systems for the VM device as 
follows: 
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1. Determine the functionality you require; that is, the utilities and 
application programs you want to run. 


2. Determine how many blocks those files need on the VM device. Remember 
to include the mandatory set of system (.SYS) files and utilities that 
RT-11 requires to run, which are listed in Section C.5.3. If you have 
a diskette drive as part of your hardware configuration, a useful 
exercise is to copy all the files to an initialized diskette, then boot 
that diskette and examine its size. 


3. Determine the base address for the VM device for that working system. 
Setting the base indicated below produces a VM device with the 
indicated number of blocks on computers containing 512K-bytes of 


memory : 
Base Number of Blocks 
7000 558 
6000 622 
5000 686 
4000 750 
3000 814 
Remember that you have a finite amount of extended memory. Therefore, 
do not create a VM device that is larger than you need. (The larger 


the VM device, the smaller the amount of remaining extended memory.) 
You do not need to specify the exact values given above; the value 4200 
is valid for example. 


4. Create a start-up command file. 


5. Create an indirect command file to set the VM device base, initialize 
VM, and copy your files to VM. 


The following three sections describe creating and running different types of 
working systems for the VM device. 


C.7.1 A MACRO Programmer’s Working System 


The following indirect command files can be appropriate for creating a working 
system for writing, assembling, linking, and debugging MACRO programs. The 
working system assumes a computer containing 512K-bytes of memory. The base 
address of VM is changed to 4000, creating a 750-block VM device, to provide 
enough free blocks for the MACRO and LINK work files. To create a MACRO 
programmer’s working system: 


1. Use the KEX editor to create a start-up command file and name it 
STARTP .COM. Include in that file all commands you want executed when 
you boot this working system. The following file may be appropriate: 


ASS LS LP 
ASS VMO CF 
ASS VMO WF 
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ASS ddn DK ! ddn represents your actual disk 
! handler and unit number 

LOAD dd ! dd represents your actual disk 
! handler 

RUN SETUP 

VT100, JUMP, LIGHT, CLEAR 

RUN RESORC 

/X 

as & 


2. Use the KEX editor to create the following indirect command file and 
name it VMPRG.COM. In the following commands, ddn represents the disk 
device handler and unit number from which you are copying the files, 


and ddX represents your disk device handler. Include the following 
commands in that file: 


SET VM SIZE=0 

SET VM BASE=4000 

UNLOAD VM 

REMOVE VM 

INSTALL VM 

INIT/NOQ VM: 

COPY/SYS ddn: (SWAP, RT11XM, VMX,ddX) .SYS VM: 
COPY/SYS ddn: (LSX,SDSX) .SYS VM: 

COPY ddn: (DUP,PIP,DIR,MACRO, LINK) .SAV VM: 
COPY ddn: (KEX,CREF,DBGSYM) .SAV VM: 

COPY ddn: (VDT.OBJ,SYSLIB.OBJ,SYSMAC.SML) VM: 
COPY ddn:STARTP.COM VM:STARTX.COM 
COPY/BOOT VM:RT11XM.SYS VM: 


Then, to use the VM device for writing, assembling, linking, and debugging MACRO 
programs: 


1. Close any files you now have open. 


2. If you are now running on your physical disk, issue the following 
commands. 


_S@VMPG <RET> 
_BOOT VM: <RET> 


If you are now running on your VM device, issue the following commands. 


In the first command, ddn represents your disk system device handler 
and unit number. 


,BOOT ddr: <RKETO 


_S@VMPG <RET> 
~_BOOT VMe <RETS 


C.7.2 A Working System for Performing a SYSGEN 


You can decrease the time required to perform a,SYSGEN by running RT-11 from the 
VM device. Use the following procedure: 


i 
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Use the KEX editor to create a start-up command file named STARTG.COM. 
Include the following command lines in that file: 


ASS LS LP 

SET LS ENDPAG=1,NOFORMO 

ASS ddn DK ! ddn represents your default data disk handler and 
unit number 

LOAD dd ! dd represents your default data disk handler 
ASS VMO CF 

ASS VMO WF 

RUN . SETUP 

VT100, JUMP, LIGHT, CLEAR 

RUN RESORC 

/X 

oe 


Use the KEX editor to create an indirect command file named VMGEN.COM. 
The base of VM is set to 4000, giving a VM device size of 750 blocks. 
In the following commands, ddn represents the disk device handler and 
unit number from which you are copying the files, and ddX represents 
your disk device handler. Include in that file the following command 
lines: 


SET VM SIZE=0 

SET VM BASE=4000 

UNLOAD VM 

REMOVE VM 

INSTALL VM 

INIT/NOQ VM: 

COPY/SYS ddn: (SWAP, RT11XM, VMX,ddX) .SYS VM: 
COPY/SYS ddn:LSX.SYS VM: 

COPY ddn: (DUP,PIP,DIR,MACRO, LINK) .SAV VM: 
COPY ddn:IND.SAV VM: 

COPY ddn: (SYSMAC.SML,SYSLIB.OBJ) VM: 

COPY ddn:STARTG.COM VM:STARTX.COM 
COPY/BOOT VM:RT11XM.SYS VM: 


To perform the SYSGEN procedure while running RT-11 from your VM device: 


Le 


ie 


Close any files you now have open. 


If you are now running on your physical disk, issue the following 
commands : 


S@VMGEN <RET> 
BOOT VM: <RET> 


If you are now running on your VM device, issue the following commands. 
In the first command, ddn represents your system disk device handler 
and unit number. 


.BOOT ddn: <RET> 


.S@VMGEN <RET> 
BOOT VMe <KET> 
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3. Once you have booted the VM device, start the SYSGEN procedure: 
.RUN SY: IND.SAV SYSGEN.COM <RET> 


Perform the procedure as documented in the RT7-1l1 System Generation 
Guide. At the end of the SYSGEN dialog, be sure to specify your 
physical disk (ddn) as the device that contains the source input files 
and as the device to which you want to send all output files. 


C.7.3 A Minimal Working System 


The following working system contains only those files necessary to boot the VM 
device. The base address of VM is set to 5000, giving a device size of 686 
blocks. The procedure uses the minimum functionality STARTX.COM start-up 
command file you created in Section C.5.1. 


You then copy programs to the VM device and thereby increase the performance 
attainable by those programs. To create a general purpose working system: 


1. You have already created the start-up command file STARTX.COM. 


2. Use the KEX editor to create the indirect command file, VMMIN.COM. In 
the following commands, ddn represents the disk device handler and unit 
number from which you are copying the files, and ddX represents your 
disk device handler. Include the following commands in that file: 


SET VM SIZE=0 

SET VM BASE=5000 

UNLOAD VM 

REMOVE VM 

INSTALL VM 

INIT/NOQ VM: 

COPY/SYS ddn: (SWAP, RT11XM, VMX,ddX) .SYS VM: 
COPY ddn: (DUP, PIP,DIR) .Sav VE: 

COPY ddn:STARTX.COM VM: 

COPY/BOOT VM:RT11XM.SYS VM: 


Then, to use the VM device as a high-speed general purpose working system: 
1. Close any files you now have open. 


2. If you are now running on your physical disk, issue the following 
commands: 


.S@VMMIN <RET> 
.BOOT VM: <RET> 


If you are now running on your VM device, issue the following commands. 
In the first command, ddn represents your disk system device handler 
and unit number. 


.BOOT ddn: <RET> 
.S@VMMIN <RET> 
.BOOT VM: <RET> 
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Once you have booted the VM device, copy any programs you want to run 
to it. Then, run those programs from the VM device. 
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USING THE LOGICAL DISK (LD) UTILITY 


This appendix contains information and exercises for creating, using, and 
Maintaining logical disks on your computer system. 


This appendix is divided into an explanation of why you might want to use the 
logical disk (LD) utility followed by the steps required to create logical 
disks. The command syntax for each step is shown. The appendix ends with an 
example session in which you create and manipulate a logical disk. 


You can use the on-line index utility, INDEX, and the on-line help utility, 
HELP, to find more information on topics described in this appendix. 


D.1 SHOULD YOU USE LOGICAL DISKS? 


You might create logical disks on your computer system for any of the following 
reasons: 


@ You are working with files that can be logically divided into groups and 
you want to keep those groups separate. 


You can use logical disks to store sets of files. You can assign a 
logical disk as your default data device and read and write data 
automatically to that logical disk. Storing all files of a group on one 
or more logical disks can help you keep track of those files. 


You can nest logical disks within another logical disk. Thus, you can 
keep sets of files, each set in its own logical disk, within a larger 
group of files on a logical disk. 


@ You can create logical disks of the same size as another type of device. 


If your computer system is made up of a large fixed disk drive and a 
smaller removable disk drive, you can subset the large disk drive into a 
series of logical disks of the smaller drive size. Copy and backup 
operations between the fixed and removable disks can then be done as 
device-to-device rather than file-to-file operations. 
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® You have exceeded the number of directory entries supported by your 
physical disk. 


Each type of physical disk supports a certain number of directory 
segments and therefore directory entries. You can exceed that number of 
directory entries while still having free space on the disk. Because 
each logical disk has its own directory, subsetting a physical disk into 
logical disks creates more directory entry space on the physical disk. 


D.2 CREATING LOGICAL DISKS 


You can create any number of logical disks on a device. You can however access 
up to only eight of them at one time. 


The following information pertains to creating logical disks: 


@® You use the CREATE command to create a logical disk on a device. The 
device on which you create a logical disk does not need to be loaded. 


® You use the CREATE command /ALLOCATE:size option to set the number of 
decimal blocks you want for that logical disk. 


The usable size of the logical disk will be smaller than the size you 
allocate, because the logical disk must also contain the file directory. 
The number of blocks used for the file directory structure is determined 
by the size of the logical disk. For example, a 100-block logical disk 
uses an 8-block file directory structure; a 6000-block logical disk uses 
a 38-block file directory structure. 


® Although not a requirement, all logical disks should be created with the 
file type .DSK. RT-11 assumes a logical disk is of file type .DSK if 
the file type is not specified in a command. Also, using that file type 
lets you easily find all the logical disks on a physical disk. 


® You should assign a file name to the logical disk that acts as a 
mnemonic, reminding you what that logical disk contains. 


The following command syntax creates a logical disk. In the command, ddn 
represents the device and unit number on which you are creating the logical 
disk, file is the logical disk name, and nnnnnn is the size of the logical disk 
in decimal blocks. 


.CREATE ddn:file.DSK/ALLOCATE:nnnnnn <RET> 


D.3 ASSOCIATING THE LOGICAL DISK WITH A LOGICAL DISK UNIT 


The logical disk utility contains a set of tables that associate logical disks 
with logical disk unit numbers. You can also optionally assign a name of 
one-to-three characters to that logical disk. That name must begin with an 
alphabetic character and must not be the same as any device installed on your 
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system. The association (but not any name assignment) iS maintained until you 
change it; the tables are not destroyed even when you shut off your computer. 


Eight logical disk units are available with which you can associate logical 
disks. Those logical disks units are LDO through LD7. 


Use the MOUNT command to associate a logical disk on a device with one of the 
eight logical disk units. The logical disk is protected from deletion once you 
associate it with a logical disk unit. For LD to associate the logical disk 
with the logical disk unit, the device containing the logical disk must be 
loaded. If that device is not already loaded, RT-11 automatically loads it as 
part of the MOUNT command. However, if you explicitly unload that device or 
reboot your processor and do not again load that device, the association is 
lost. You can regain that association by again loading that device. 


The following command syntax associates a logical disk with a logical disk unit. 
In the command, LDn represents a logical disk unit between LDO and LD7, ddn 
represents the device containing the logical disk, and nam represents a name you 
can optionally assign to that logical disk. 


.MOUNT LDn: ddn:file.DSK [nam] <RET> 


You can make a logical disk unit read only, using the MOUNT command /NOWRITE 
option. If you make a logical disk unit read only and later decide to allow 
writing to it, you must mount it again and include the /WRITE option. 


Once you have associated a logical disk with a logical disk unit, you direct all 
commands and operations to that logical disk unit. If you have assigned a name 
to that logical disk, you can direct commands and operations to that name. 


D.4 MAKING THE LOGICAL DISK USABLE 


The first association of a logical disk with a logical disk unit does not make 
that logical disk usable. You must create a file directory structure on that 
logical disk before you can use it. You use the INITIALIZE command to create a 
file directory structure on a logical disk, just as you do on a physical disk. 


The following command syntax initializes a logical disk. In the command syntax, 
LDn represents the logical disk unit you associated with a logical disk. You 
can optionally use the INITIALIZE command /NOQUERY option to suppress the RT-11 
Foreground loaded; Are you sure? prompt. 


.INITIALIZE/NOQUERY LDn: <RET> 


Once you have created a file directory structure on the logical disk associated 
with unit LDn, you can use it as though it was a physical disk. If you break 
the association between that logical disk and unit LDn (to perhaps associate a 
different logical disk with unit LDn), you can use that logical disk again by 


associating it with unit LDn or a different unit. 
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D.5 CHANGING THE LOGICAL DISK ASSOCIATION 


RT-11 allows you eight logical disk associations at one time, though you can 
have far more than eight logical disks on your system. Therefore, as you work 
with your logical disks, you can periodically change the logical disks you have 
associated with your available eight logical disk units. 


Use the following command to determine the status of your logical disk unit 
associations: 


. SHOW SUBSET <RET> 


Just as you use the MOUNT command to associate a logical disk with a logical 
disk unit, so too, you use the DISMOUNT command to break the association between 
a logical disk and a logical disk unit. Use the following command syntax, where 
IDn represents that logical disk unit: 


.DISMOUNT LDn: <RET> 


D.6 NESTING LOGICAL DISKS 


You can include (nest) one or more logical disks within a larger logical disk. 
You may, for example, have one or more subclasses of files that can be logically 
grouped within a larger class of files. You can create a primary logical disk 
for the entire class of files and nest a logical disk for each of the subclasses 
of files. 


It might help to think of a logical disk as a box that can contain up to 65K 
blocks. That box can contain files and other nested logical disks. Those 
nested logical disks are also boxes that can contain files and other nested 
logical disks, and so on. The total size of all files and nested logical disks 
in the primary logical disk cannot exceed 65K blocks. 


You must associate a higher unit number with a nested logical disk than that 
associated with the primary logical disk. For example, assume you intend to 
mount a primary logical disk and three logical disks that are nested within it. 
Assume also that you have already mounted two logical disks and associated them 
with unit numbers LDO and LD1. You would probably want to associate the primary 
logical disk with unit number LD2 and the three nested logical disks with unit 
numbers LD3, LD4, and LD5. 


A method for nesting logical disks follows. The commands used are explained in 
the previous sections. 


1. Create a primary logical disk large enough to hold the files and nested 
logical disks you foresee it containing. Use the CREATE command with 
the /ALLOCATE option. 
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Use the MOUNT command to associate that logical disk with a logical 
disk unit. Assume you are associating that logical disk with unit LDO. 


Use the INITIALIZE command to initialize that logical disk. 
The two ways to nest logical disks are: 


@e You can nest logical disks that already exist. Use the COPY 
command to copy those logical disks you want to nest to the primary 
logical disk. Then, do a directory operation on the primary 
logical disk to verify the presence of the nested logical disks and 
that the number of free blocks is as you expect. 


® You can also use the CREATE command and the /ALLOCATE option to 
create nested logical disks in the primary logical disk. 


Assume you are creating three logical disks to nest in the primary 
logical disk. You can create and. nest any number of logical disks, 
limited only by the size of the primary logical disk. 


Recall that the primary logical disk was mounted as LD0O. The 
following series of commands creates three nested logical disks, 
FIRST.DSK, SECND.DSK, and THIRD.DSK, on the primary logical disk 
you associated with LDO. The size you allocate to each is 
represented by nnnnnn: 


,CREATE LDO:FIRST.DSK/ALL:nnnnnn <RET> 
.CREATE LDO:SECND.DSK/ALL:nnnnnn <RET> 
, CREATE LDO:THIRD.DSK/ALL:nnnnnn <RET> 


Associate each of the nested logical disks in the primary logical disk 
with a different logical disk unit number. Each nested logical disk 
unit number must be higher than the primary logical disk unit. number. 
Recall that the nested logical disks were created as FIRST.DSK, 
SECND.DSK, and THIRD.DSK, and that the primary logical disk was mounted 
as unit LDO. Given that, the series of commands to mount the nested 
logical disks could be: 


.MOUNT LD1: LDOQ:FIRST.DSK <RET> 
.MOUNT LD2: LDOQ:SECND.DSK <RET> 
.MOUNT LD3: LDO:THIRD.DSK <RET> 


The first association of each logical disk protects it from deletion. 
Therefore, FIRST.DSK, SECND.DSK, and THIRD.DSK are now protected from 
deletion. 


Initialize logical disks LD1, LD2, and LD3: 
JINITIALIZE/NOQUERY LD1: <RET> 


.INITIALIZE/NOQUERY LD2: <RET> 
,INITIALIZE/NOQUERY LD3: <RET> 
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7. Issue the following command to verify the status of the logical disks: 


»~SHOW SUBSET <RET> 


8. If you do a directory operation on the physical device containing 
logical disk LDO, you notice that only the primary logical disk is 
displayed. You need to mount that logical disk and do a directory 
operation to display the nested logical disks. Therefore, you cannot 
access a mounted nested logical disk unless the primary disk is also 
mounted. 


9. If you dismount (break the association) between the primary logical 
disk and its logical unit without first dismounting nested logical 
disks, you should issue the following command to free the nested 
logical units: 


~SET LD CLEAN <RET> 


D.7 USING THE LOGICAL DISK 


Once you have created a logical disk, associated that logical disk with a 
logical disk unit, and initialized that logical disk, you can use it like a 
physical disk. You can write to it, read from it, and use it as your default 
data (DK) device. 


In the following exercises, you create a logical disk and associate it with a 
logical disk unit. You initialize that logical disk, examine its directory 
size, and perform directory operations to it. You create a nested logical disk 
within the primary logical disk and examine their relationship. Finally, you 
dismount and delete both logical disks. This exercise uses your default data 
(DK) device; you can create and use logical disks with any disk on your system. 


1. Determine if LD is installed on your system by issuing the following 
command: 


»-SHOW <RET> 
If LD is listed in that display, LD is installed on your system. If LD 


is not displayed and is therefore not installed on your system, issue 
the following command: 


~ INSTALL LD <RET> 


2. Determine the decimal number of free blocks on your current default 
data (DK) device by issuing the following command: 


»DIR/FREE <RET> 


3. The following command creates a 100-block logical disk on your DK 
device. If the previous command did.not display any free block region 
of at least 100 blocks, use the largest displayed free block region 
rather than 100 in the following command: 
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, CREATE INTRO.DSK/ALLOCATE:100 <RET> 
RT-11 creates the logical disk INTRO.DSK. 


Display all entries in your DK device of type .DSK: 


~DLRECTORY *.DSK <RET> 
That command should display the entry INTRO.DSK. 


Associate the logical disk INTRO.DSK with logical disk unit LDO: 


.MOUNT LDO: DK:INTRO.DSK <RET> 


The first association of any logical disk with a logical disk unit 
causes RT-11 to protect that disk from deletion. Also, if not already 
loaded, RT-11 always loads the device containing the logical disk. 
(For the logical disk to associate with the logical disk unit, the 
device containing the logical disk must be loaded.) Once you have 
associated a logical disk with a logical disk unit, you direct all 
commands and operations to the logical disk unit. 


Initialize logical disk unit LDO: 


, INITIALIZE/NOQUERY LDO: <RET> 
Examine the directory of logical disk unit LDO: 


,DIKECTORY LDQ: <RET> 


Notice that although you allocated 100 blocks for LDO, the directory 
command displays a 92-block device. The 8-block difference is the file 
directory structure for the logical disk mounted on unit LDO. 


Examine the status of your logical disk units: 


. SHOW SUBSET <RET> 


Create a 30-block nested logical disk, NEST.DSK, in the logical disk 
mounted on LDO. Mount NEST.DSK on logical disk unit LD1 and initialize 
ee 


.CREATE LDO:NEST.DSK/ALLOCATE:30 <RET> 
MOUNT LDL: LDQ: NEST, DSK <RET> 
. INITIALIZE/NOQUERY LD1: <RET> 


Do a directory operation on your DK device for files of the type .DSK 
and notice that NEST.DSK does not appear. Do a directory operation on 
LDO to display NEST.DSK. Do a directory operation on LD1 and notice 
its size. 


~DIRECTORY *.DSK <RET> 
- DIRECTORY LDU: <RET> 
-DIBECTORY LD: <RET> 
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Issue the following command to display the relationship between the 
nested and primary logical disk units: 


~~ 


SHOW SUBSET <RET> 


10. Break the association between nested logical disk NEST.DSK and logical 
disk unit LD1 and between INTRO.DSK and LDO: 


_DISMOUNT LD1: <RET> 
“DISMOUNT LDO: <RET> 


li. Unprotect Logical disk INTRO.DSK: 
_UNPROTECT INTRO.DSK <RET> 


12. Delete logical disks NEST.DSK and INTRO.DSK.  NEST.DSK is nested in 
INTRO.DSK, so deleting INTRO.DSK also deletes NEST.DSK. 


_DELETE INTRO.DSK <RET> 
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Do not worry that a primary logical disk may become too small to contain further 
files and nested logical disks (if you have not already allocated it the 
65K-block limit). Assuming you have enough space on a physical disk, you can 
always make that primary logical disk larger. Use the following procedure: 


1. Use the MOUNT command to associate the smaller logical disk with a YY 
logical disk unit. 


2. Use the CREATE command to create a larger logical disk. Use the 
/ALLOCATE option to specify the new size. This larger logical disk 
does not need to be on the same physical device as the smaller logical 
disk. Use the MOUNT command to associate the larger logical disk with 
a logical disk unit. Initialize that larger logical disk. 


3. Copy the files and nested logical disks from the smaller logical disk | | 
to the larger logical disk. If the smaller logical disk is mounted as 
LDO and the larger is mounted as LD1, the command is: 


_COPY/SYSTEM/VERIFY LDO:*.* LD1:*.* <RET> 


The /VERIFY option causes RT-11 to perform error checking during the 
copy operation. Depending on the size of the logical disks and the 
type of physical device involved, this operation could take some time. 


4, When the copy operation completes, you should back up the smaller 
logical disk. You can then dismount it, unprotect it, and delete it. 
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USING THE SINGLE-LINE (SL) COMMAND EDITOR 


This appendix describes using the Single-Line (SL) command editor. In general, 
SL lets you store, recall, manipulate, and edit command lines. Using SL saves 
you time, because SL streamlines the command-issuing process. 


You can use most SL functionality with any distributed RT-11 monitor. However, 
you must be running the XM monitor to use the powerful RECALL command function, 
and using SL under the XM monitor requires the least amount of limited low 
memory. 


You can use the on-line index utility, INDEX, and the on-line help utility, 
HELP, to find more information on topics described in this appendix. 


NOTE 


In this appendix, angle brackets are used to indicate a key on 
your keyboard or keypad. For example, <PF1> represents the key 
marked PF1l on your keypad, and <S> represents the S key on your 
keyboard. 


E.1 WHY YOU SHOULD USE SL 
Use SL for any of the following reasons: 


1. Computers are often used for repetitive tasks. Unfortunately, you too 
are often required to repeat tasks when you use your computer. For 
example, suppose you must initialize a dozen floppy diskettes and 
examine those diskettes for bad blocks. Without SL, you have to type 
the following command a dozen times (where ddn: represents your 
diskette drive and unit number): 


. INITIALIZE/BADBLOCKS /NOQUERY ddn: <RET> 


Using SL, you type (issue) that command once. Then, when it is time to 
reissue that command, you press the <Up-Arrow> key and then press 
<RET>. Pressing <Up-Arrow> recalls that command and pressing <RET> 
issues it. 
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2. Suppose you mistype a command. RT-1ll returns an error message 
indicating an invalid command or option to that command. Without SL, 
you retype that command (and perhaps mistype it again). Using SL, you 
press the <Up-Arrow> key to recall that command. You then examine the 
command, determine your mistake, correct your mistake using SL, and 
press <RET>. 


3. You often reissue a command after modifying just a small fragment of 
that command. Without SL, you retype the entire command. Using SL, 
you recall the command, edit the small fragment using SL, and reissue 
the command. 


4. SL stores previous commands in a 512-byte buffer. Under any RI<12 
monitor, you can continuously press the <Up-Arrow> key to scroll 
through those previous commands. You then press the <RET> key to issue 
any of those previous commands. 


Under the XM monitor, you can use the SL command RECALL/ALL to display 
the stored commands. You can then recall a specific command by using 
either the number displayed next to each command or the _ shortest 
unambiguous abbreviation for that command. You then press the <RET> 
key to issue that recalled command. 


5. You often repeat a set of commands. You might repeatedly edit, 
compile, link, and run a program. Without SL, you type the same set of 
commands repeatedly as you debug your code. Using the functionality, 
"set cycle" and "cycle," you use just three keystrokes to sequentially 
display and repeat each command in the set. 


6. You may find that you often issue a particular command. SL lets you 
save one command that you can randomly issue as you need it. 


This appendix describes and provides examples of how to perform those functions. 


You can also use the distributed on-line index program, INDEX, to find all 
references to SL in the RT-11 documentation. 


E.2 TURNING ON SL 

The RT-11 monitor you are using determines which SL functionality is available. 
You enable different SL functionality by specifying various conditions with the 
SET SL command. All SL set conditions are described in the R7-11 System User’s 
Guide. The SL conditions described in this appendix are: 


KED Turns on keypad editing functionality. Keypad editing is 
available under all RT-11 monitors. 


KMON Turns on SL and sets it to edit only keyboard monitor commands. 
The KMON condition can be used under all RT-11 monitors. 


OFF Furns off SL under all monitors. 
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ON Turns on SL and sets it to edit both keyboard monitor and CSI 
commands. If you use the CSI command syntax, you should turn on 
SL, using the ON condition. Otherwise, use the KMON condition. 
Because this chapter uses only keyboard monitor commands, the 
KMON condition is shown. 


RECALL Lets you use the RECALL keyboard command. RECALL, the most 
advanced SL functionality, can be used with only the XM monitor. 


SYSGEN Matches certain SL characteristics with any RT-11 monitor you may 
have built, using the SYSGEN procedure. Setting the SYSGEN 
condition is described further in this section. 


Depending on which monitor you are running, use one of the following two series 
of commands to turn on SL: 


If not running XM: 
Issue the following command: 
.SET SL KED,KMON <RET> 


If RT-1l1 returns an error message indicating an invalid command, a conflict may 
exist between SYSGEN conditons for your monitor and SL, and RT-11 could not 
install SL. Issue the following commands to match SL with your RT-11 monitor’s 
characteristics: 


.SET SL SYSGEN <RET> 
, INSTALL SL <RET> 
.SET SL KED,KMON <RET> 


If running the XM monitor: 
Issue the following command: 
»SET SL RECALL, KED,KMON <RET> 


If RT-11 returns an error message indicating an invalid command, a conflict may 
exist between SYSGEN conditons for your monitor and SL, and RT-11 could not 
install SL. Issue the following commands to match SL with your RT-11 monitor’s 
characteristics: 


-SET SL SYSGEN <RET> 
»-INSTALL SL <RET> 
-SET SL RECALL, KED,KMON <RET> 


E.3 EDITING THE COMMAND LINE 


One of the major SL functions is command line editing. Without command line 
editing, any change you want to make to a command line requires that you delete 
all characters from your current cursor position to the character you want to 
change or add. Because you turned on SL in the previous section, you can now 
move the cursor directly to that part of the command line you want to change 
without having to delete any intervening characters. 
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Two levels of editing functionality are available to you. The first level, the 
basic level, is available when you turn on SL. An enhanced level, keypad 
editing, is available when you set the SL condition KED. No memory penalty 
occurs with turning on keypad editing; the keypad editing functionality uses no 
extra computer memory. 


Because you set the SL condition KED when you turned on SL in Section E.2, you 
have both levels of functionality available and you can combine the features of 
both levels. 


You should understand basic command line editing before you examine the enhanced 
functionality available with keypad command line editing. 


E.3.1 Basic Editing of the Command Line 
Basic command line editing generally involves two types of operations: 


1. First, you use the arrow keyboard keys to move your cursor through the 
command line and into and out of the stack of previous commands. You 
use the <Left-Arrow> and <Right-Arrow> keyboard keys to move through 
the command line. If you need to recall a command before editing, you 
use the <Up-Arrow> and <Down-Arrow> keyboard keys to move through the 
command stack to recall that command. 


2. Once you have placed your cursor at the desired location, you use other 
keypad and keyboard keys to delete, add, and manipulate characters 
within the command line. 


As SL is distributed, any character you type within a command line is 
added; that functionality is called INSERT mode. You can change that 
functionality while editing a command line so that any character you 
type replaces the character located at the cursor position; that is 
Called REPLACE mode. You alternate between INSERT and REPLACE mode by 
pressing <CTRL/A>. The Single-Line command editor returns to INSERT 
mode each time you press <RET> to issue a command. 


The following table lists the keypad and keyboard keys you can use with basic 
command line editing and their functions. Following the table is an exercise 
that demonstrates using those keys. 


Key Function 

<PFi> Alternate function key. Also referred to as the GOLD key. 
Changes the function of other keys when used in combination 
with them. 

<PF1> <S> Saves the displayed command. The <S> key is located on your 


main keyboard and is not case sensitive. 


<PE I> <> Displays the saved command. The <xX> key is located on your 
main keyboard and is not case sensitive. 
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<PF2> 


<PF4> 


<Up-Arrow> 


<Down-Arrow> 


<Left-Arrow> 


<Right-Arrow> 


<Line-Feed> 


<Delete> 


<Backspace> 
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The help key. Press <PF2> to display a screen of helpful SL 
information on the top half of your screen (above the 
command line). If you first issue the command, SET SL 
LEARN, subsequently pressing <PF2> causes the SL help screen 
to be locked onto the display. Issue the command SET SL 
NOLEARN to remove the help screen. 


Delete line function key. Deletes command line from cursor 
position to end of line. 


The <PF1> <PF4> combination restores the deleted line. 


Moves the cursor into the command stack, displaying previous 
commands. 


The <PF1> <Up-Arrow> combination displays the next command 
in the current cycle of commands. This cycle functionality 
is described in Section E.4.3. 


Moves the cursor out of the command stack, displaying 
previous commands. 


The <PF1> <Down-Arrow> combination establishes an offset 
into the stack of previous commands. This set cycle 
functionality is described in Section E.4.3.2. 


Moves the cursor toward the beginning of the command line. 


The <PF1> <Left-Arrow> combination moves the cursor to the 
beginning of the command line. 


Moves the cursor toward the end of a command line. 


The <PF1> <Right-Arrow> combination moves the cursor to the 
end of the command line. 


Deletes the word to the left of the cursor. 


Deletes the character or character position to the left of 
the cursor. 


The <PF1> <Delete> combination restores that deleted 
character or character position. 


Switches the character at the current cursor position with 
the character to the right of the cursor. 


The <PF1> <Backspace> combination switches the character at 
the current cursor position with the character to the left 
Of Che Cursor. 
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<CTRL/H> Same as <Backspace>. 

<CTRL/J> Same as <Linefeed>. a 
<CTRL/R> Redisplays the current command line. Use <CTRL/R> 

<CTRL/W> or <CTRL/W> to refresh the command line on .your terminal 


screen if the command line becomes garbled or corrupted. 


<CTRL/U> Deletes all characters from the current cursor position to 
the beginning of the command line. 


The <PF1> <CTRL/U> combination restores those deleted 
characters. 


<RET> The RETURN key. Issues the. currently displayed command. 
You can press <RET> and issue a command no matter where the 
current cursor position in that command. 
The <PF1> <RET> combination truncates the command (deletes | | 
all characters from the cursor position to the end of the ed 
command line) and issues the truncated command. 
The following exercise shows basic command line editing: 


1. Type the following command but do not press <RET>: 


,DIRECTORY/FULL SY: 
2. Press the <PF1> <S> keys to save that command. 


3. You could press <RET> and issue that command. However, for the purpose 
of this exercise, press <CTRL/U> to delete the command line. 


4, Issue the following misspelled command exactly as shown: 


,DILECTORY/PROTECT/ODRER:SIZE SY: <RET> 


RT-11 returns an error message indicating an invalid command or that 
the command does not exist. | ) 


5. Press the <Up-Arrow> key. 

6. SL recalls the previous command: 

. DILECTORY/PROTECT/ODRER: SIZE SY: 

7. Examine that command line and notice that the command DIRECTORY is 
misspelled as DILECTORY and the option /ORDER:SIZE is misspelled as 
/ODRER: SIZE. 

8. Press the <PF1> <Left-Arrow> keys. The cursor is then located at the 


beginning of the command line. Press the <Right-Arrow> key until your 
cursor iS positioned at the E character in DILECTORY: 
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. DILECTORY/PROTECT/ODRER:SIZE SY: 
(If you go too far, you can return using the <Left-Arrow> key.) 
9. Press the <Delete> key. 
10. Type the letter R. 


11. You now correct the misspelled option /ODRER/SIZE. Press the 
<Right-Arrow> key until the cursor rests on the letter D: 


. DIRECTORY/PROTECT/ODRER: SIZE SY: 


12. Press the <Backspace> key to switch the letter D with the letter to the 
right of it (R). Press the <RET> key. 


You have corrected the command and it executes. 


13. Press the <PF1> <xX> keys to display the command you saved at the 
beginning of this exercise. Press <RET> to issue that command. 


14. Continuously press the <Up-Arrow> key to verify you have stored the 
commands you issued in this exercise on your stack of previous 
commands. After you display all the commands on your stack of previous 
commands, you are returned to the monitor prompt (.). 


15. Press and hold down the <Down-Arrow> key. You scroll back out through 
your stack of previous commands to the monitor prompt (.). 


E.3.2 Keypad Editing of the Command Line 


The keypad method lets you use your keypad editing keys to recall command lines, 
move the cursor, and edit the command line. This method requires that you know 
the function of the keypad keys. 


In keypad mode, you use the keypad to edit the command line as you would use the 
keypad from within the KED editor. Use the KED keypad functions appropriate for | 
editing text within a single line. The following table lists those keypad keys 
you use to recall commands, move the cursor, and edit command lines. Following 
the table is a series of exercises that demonstrate using those keys. 


Key Function 

<PF1> Alternate function key. Changes the function of other keys 
when used in combination with them. Also referred to as the 
GOLD key. 

<PF2> Displays a HELP frame on your terminal screen. 

<PF4> Delete line function key. Deletes the command line from the 


cursor position. 
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The <PF1> <PF4> combination restores that deleted command 


Line . | | 

ee | id 
<0> Beginning-of-line function key. Moves the cursor to the 
beginning of the command line. If the cursor is at the 


beginning of the command line, <0> moves the cursor to the 
beginning of next previous or next most recent command line. 


The <PF1> <0> combination is the open-line function. 
Produces a blank line for entering a command. 


<1> Syntax element function key. 


Causes the cursor to move across one element of syntax. An 
element of syntax can be the device handler name and unit 
number, file name, file type or extension, command, any 
options, and any arguments to those options. 


<2> End-of-line function key. Moves the cursor to the end of | | 
the command line. If the cursor is at the end of the \ J 
command line, <2> moves the cursor to the end of the next 
previous or next recent command line. 


The <PF1><2> combination deletes all characters from the 
cursor position to the end of line. 


<3> Character function key. Moves the cursor one character 
position. 

<4> Forward function key. Causes subsequent cursor movement to ed 
be forward. 

<5> Reverse function key. Causes subsequent cursor movement to 


be in reverse. 


<,> Delete character function key. Deletes one character at the 
cursor position. 


The <PF1> <,> combination restores that deleted character. 


<-> Delete syntax element function key. Deletes one element of 
command syntax at the cursor position. 


The <PF1> <-> combination restores that element of command 
syntax. 


<Enter> Equivalent to <RET> key. Issues the displayed command. 


The keypad keys <.> <6> <7> <8> <9> and <PF3> are not implemented. 
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Exercises 
The following exercises demonstrate keypad command line editing: 
Exercise One 


This exercise recalls a command you typed previously and corrects the 
misspelling in that command. 


1. Press the <5> <0> keypad keys until the following misspelled command is 
displayed: 


. DILECTORY/PROTECT/ODRER:SIZE SY: 
Your cursor is resting at the beginning of the command line. 
2. Press the <4> keypad key to direct cursor motion forward. 
3. Press the <3> keypad key twice so the cursor rests on the letter L: 
. DIZLECTORY/PROTECT/ODRER: SIZE SY: 
4. Press the <,> keypad key to delete the letter L. 
5. Type the letter R. 


6. Press the <1> keypad key twice and the <3> keypad key twice so the 
cursor rests on the D: 


. DIRECTORY/PROTECT/ODRER: SIZE SY: 


7. Press the <,> keypad key to delete the letter D. Press the <3> keypad 
key so the cursor advances one character and type D. Press <RET>. 


The command executes. 
Exercise Two 
This exercise recalls a previous command and changes an option argument. You 
also change the device for which you want the directory display from your 
default data (DK) to system (SY) device. 
1. Press the <5> <0> keypad keys to recall the command: 


, DIRECTORY/PROTECT/ORDER: SIZE SY: 


2. Press the <4> keypad key to change the cursor motion to forward. Press 
the <l1> keypad key three times to move forward three syntax elements: 


.DIRECTORY/PROTECT/ORDER: SIZE SY: 


3. Press the <-> keypad key to delete SIZE. Type DATE and press the 
<space bar>. 


4, Press the <-> keypad key to delete SY:. 
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5. Type DK: and press <Enter>. 
The edited command now executes and gives you different information. 
Exercise Three 


This exercise recalls the previous command and changes it te return the full 
directory of your default data (DK) device. 


1. Press the <5> <0> keypad keys to recall the last command: 
. DIRECTORY/PROTECT/ORDER:DATE DK: 

2. Press the <4> <1l> keypad keys: 
. DIRECTORY/ PROTECT/ORDER:DATE DK: 


3. Press the <-> keypad key three times to delete the command options 
PROTECT/ORDER : DATE: 


. DIRECTORY/ DK: 
4. Type FULL, press the <space bar>, and press <Enter>. 


The command executes and displays the full directory of your default 
data device. 


E.4 STORING AND RECALLING COMMANDS 

Another major SL function is storing and recalling previous command lines. 
Storing Commands 

SL stores up to one block (512 bytes) of previous commands on its command 
Storage stack. Because each character and space you type in a command uses one 
byte of stack storage, you can store more commands by abbreviating commands and 


options to their shortest unambiguous length. 


You can also store a command by explicitly saving it. SL lets you save one 
command that you can randomly recall as you need it. 


Recalling Commands 

SL provides five methods for recalling stored commands. If you are using the XM 
monitor and have SET the SL conditions RECALL and KED (SET SL RECALL,KED), you 
can use all methods. Otherwise, the indicated restrictions apply. 


@ Arrow key method 


Under all monitors, you can use the <Up-Arrow> key and <Down-Arrow> key 
to scroll into and out of the command storage stack. 
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@ Keypad method 


Under all monitors with the KED condition in effect, you can use the 
keypad forward and reverse function keys with the beginning-of-line or 
end-of-line function keys to move in and out of the command storage 
stack. 


@ Cycling method 


Under all monitors, you can use the set cycle and cycle functionality to 
recall continuously a sequence of commands. 


@ RECALL command method 


To use the RECALL command, you must be using the XM monitor with the 
RECALL condition in effect. The RECALL command provides the most direct 
method for displaying and recalling previous commands. The RECALL 
command displays a numbered list of previous commands. You can recall 
any command from that list by using the command number or the shortest 
unambiguous abbreviation for that command. 


@ Save command method 


Under all monitors, you can save a displayed command by pressing the 
<PF1> <S> _ keys. You can then recall that saved command whenever you 
need it by pressing the <PF1> <X> keys. 


You issue any recalled command by pressing the <RET> key regardless of the 
cursor position within that command. 


Exercise some caution when issuing a recalled command. Be sure to carefully 
read the recalled command before pressing the <RET> key. 


The following sections describe using those methods for recalling stored 
commands. 


E.4.1 Using Arrow Keys to Recall Commands 
Use the <Up-Arrow> and <Down-Arrow> keys to recall (display) previous commands. 


You use the <Up-Arrow> key to move into your stack of previous commands. Press 
and release the <Up-Arrow> key to singly recall previous commands or press and 
hold the <Up-Arrow> key to scroll into your stack of commands. 


You use the <Down-Arrow> key to move back out through the stack. Press and 
release the <Down-Arrow> key to singly display commands or press and hold the 
<Down-Arrow> key to scroll out through the command stack to the current (empty) 
command line. 


SL returns to the monitor prompt (.) when you exceed either command stack limit; 
when you scroll into the stack beyond the first stored command or scroll out of 
the stack beyond the last stored command. You can then issue a command in 
response to that monitor prompt or use the arrow keys to reenter the command 
stack to recall and issue a previous command. 
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E.4.2 Using the Keypad to Recall Commands 


If you have enabled keypad editing, using the command SET SL KED, you can use 
the keypad to scroll into and out of your storage stack of previous commands. 
Use a combination of four keypad keys to do that. 


You use the forward function key, <4>, or the reverse function key, <5>, to set 
the direction of motion through the stack. Pressing <5> moves you into the 
stack. Pressing <4> moves you back out of the stack. You only need to set the 
direction of motion once, until you want to change it. 


The beginning-of-line, <0>, and end-of-line, <2>, function keys determine your 
cursor placement on the command line, as you move in and out of the command 
stack. 


For example, pressing the keypad sequence, <5> <0> <0>, places your cursor at 
the beginning of the command that resides two entries into the stack. Pressing 
the keypad key <5> and then pressing and holding the keypad key <0> causes SL to 
scroll through your stack of previous commands with the cursor at the beginning 
of each command. Pressing <4> and <0> in the same manner reverses the process. 


SL returns to the monitor prompt (.) when you exceed either command stack limit; 
when you scroll into the stack beyond the first stored command or scroll out of 
the stack beyond the last stored command. You can then issue a command in 
response to that monitor prompt or use the keypad to reenter the command stack 
to recall and issue a previous command. 


E.4.3 Using the Cycling Method to Recall a Sequence of Commands 


SL provides the set cycle and cycle functionality for recalling a sequence of 
commands. That method can be especially useful when you are repeating an 
operation that requires a command sequence. 


By default, SL lets you continuously repeat the previous two commands as a 
sequence. SL also lets you determine the number of commands you want to 
continuously repeat as a sequence. 


E.4.3.1 Default Cycling Functionality - You can continuously repeat the 
previous two commands in your command storage stack. That is, the default SL 
cycle functionality contains an offset of two commands. You access and repeat 
those two commands as a sequence by pressing the <PF1> <Up-Arrow> keys. Doing 
that recalls each command and pressing <RET> issues that command. 


The default cycling functionality is useful when you want to continuously repeat 
the previous two commands. How to change the number of commands you 
continuously repeat is described in the next section. 
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E.4.3.2 Changing the Cycling Functionality - You can change the set cycle and 
cycle functionality to store an offset into your storage stack of previous 
commands. After you have issued a series of commands that you then want to 
repeat, you establish the offset (set the cycle) for the first command in that 
sequence. You then cycle through that command sequence, return to that first 
command, and repeat the sequence. 


Command sequence cycling is helpful with an operation such as debugging source 
code. For example, assume you are debugging MACRO source code. That operation 
may require that you repeatedly edit, assemble, link, and run the code. You may 
repeatedly issue the commands EDIT filename, MACRO filename, LINK filename, and 
RUN filename. 


After you have issued that sequence of commands, RUN filename is the first 
stored command on your stack, and EDIT filename is the fourth. Rather than 
scroll into your stack four positions to repeat each command in the sequence, 
you can use the set cycle and cycle functionality as follows: 


1. Use the arrow keys, the keypad, or the RECALL command to recall the 
first command in the sequence (EDIT filename). Press the <PF1> 
<Down-Arrow> keys to store that offset (set the cycle) into your 
command stack. Press <RET> to issue that command. 


2. When you are ready to recall the next command in the sequence, press 
the <PF1> <Up-Arrow> keys. SL recalls the next command in the 
sequence. Press <RET> to issue that command. 


3. Continue to press the <PF1> <Up-Arrow> keys to recall successive 
commands in the sequence. Press <RET> to issue each of those commands. 


4, When you have issued the last command (RUN filename) and want to repeat 
the sequence, press again the <PF1> <Up-Arrow> keys, which recalls the 
command, EDIT filename. Press <RET> to issue that command. 


You can continue to use this command sequence cycle until you change 
the offset into your stack. You change that offset by issuing, rather 
than recalling, any command. Therefore, you should think of the _ set 
cycle and cycle functionality as a temporary method of recalling a 
particular command sequence. 


E.4.4 Using RECALL to Display and Recall Commands 


You issue the RECALL command in response to the keyboard monitor prompt (.). SL 
does not keep any RECALL command in its stack of previous commands. Therefore, 
you cannot recall the RECALL command. 


USING THE SINGLE-LINE (SL) COMMAND EDITOR 


You can use the RECALL command to: 


WY 


@e Display all previous commands stored in your command storage stack. 
The following command displays all stored previous commands: 
.RECALL/ALL <RET> 
SL displays the list of previous commands, like the following example: 


.RECALL/ALL <RET> 
1 SRUN KEX.SAV 
* 2 MOUNT LD2: DK: INTRO.DSK 
3 SHOW SUBSET 


That display includes all previous commands stored in your command 

stack. In this example display, SRUN KEX.SAV is the most recent command 

you issued, indicated by the J next to that command. The asterisk (*) i 
next to the command, MOUNT LD2: DK:INTRO.DSK, indicates that command is 

first in the current cycle of commands. 


@e Recall the previous command. 


The RECALL command with no option recalls the most recent previous 
command: 


. RECALL <RET> 
@e Recall a command, using the number displayed next to that command. 


Assuming that issuing the RECALL/ALL command returns the following 
example display: 


.RECALL/ALL <RET> 
1 SRUN KEX.SAV 
* 2 MOUNT LDZ: DK: INTRO.DSK 
3 SHOW SUBSET 


You can recall the command, SHOW SUBSET, by issuing the following 
command: 


. RECALL 3 <RET> 


@® Recall a command using the shortest unambiguous abbreviation for that 
command. 


Assuming that issuing the RECALL/ALL command returns the following 
example display: 


.RECALL/ALL <RET> 
1 SRUN KEX.SAV 
* 2 MOUNT LD2: DK: INTRO.DSK 
3 SHOW SUBSET 
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rm You can recall the command, SHOW SUBSET, by issuing the following 
command: 
. RECALL SH <RET> 
E.4.5 Saving a Command 
SL lets you save one command. You can then recall that command whenever you 
need it. You save a command, using the following procedure: 

1. The command you want to save must be displayed. You display a command 
by either typing it or recalling it from your stack of previous 
commands. 

Do not issue the command; do not press the <RET> key. 
| z. Once the command is displayed, press the <PF1> <S> keys. 
You then press <RET> to issue that command. However, you do not need 
to issue the command to save it. 
You can now recall the saved command at any time by pressing the <PF1> <X> keys. 
s i 


E.5 SLMIN - THE SMALLEST SINGLE-LINE COMMAND EDITOR 


RT-11 distributes a minimal single-line command editor that contains a subset of 
the basic command line editing functionality described in Section E.3.1. SLMIN 
needs less memory than SL. SLMIN can be an appropriate command line editor when 
you are not running the XM monitor and you are concerned about low-memory 
availability. You cannot use SLMIN if you are using the XM monitor. 


Enhanced SL functionality, such as keypad editing and the RECALL command, is not 
y oN available under SLMIN. 


SLMIN provides all the basic command line editing functionality described in 
Section E.3.1, except: 


@e There is no help screen. The <PF2> keypad key has no meaning under 
SLMIN. 


@e The stack of previous commands contains only two commands. 


@ Pressing <Linefeed> or <CTRL/J> does not delete previous commands, but 
rather is equivalent to pressing <RET>. 


All other basic command line editing functionality is available. 
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Issue the following commands to preserve the distributed SL and rename SLMIN to 
SL: 


,RENAME SL.SYS SL.DIS <RET> 
,RENAME SLMIN.SYS SL.SYS <RET> 
,REMOVE SL <RET> 
_ INSTALL SL <RET> 
You then turn on SLMIN as SL by issuing the following command: 
,oET SL KMON 
If you want return to using the distributed SL command line editor, you issue 
the following commands: 
,RENAME SL.SYS SLMIN.SYS <RET> 
,RENAME SL.DIS SL.SYS <RET> 
REMOVE SL <RET> 
, INSTALL SL <RET> >» 
_SET SL KED,KMON <RET> New 


(or, 
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ENHANCEMENTS TO THE BACKUP (BUP) UTILITY BETWEEN V5.4 AND V5.4D 


This appendix describes the enhancements that were added to BUP between RT-11 
v5.4 and V5.4D. The major enhancements involve BUP magtape operations. The 
enhancements to BUP for disk operations are less major. 


The main release demarcation is V5.4B. Volumes created by BUP prior to V5.4B 
can be restored by the V5.4B or subsequent BUP. However, volumes created by the 
V5.4B or subsequent BUP require at least the V5.4B BUP for restoration. 


This appendix is separated into five major sections: 


@e The first section lists the new or changed BACKUP command and BUP CSI 
options. 


@ The second section describes those enhancements made to BUP for disk 
operations. 


@ The third section describes those enhancements made to BUP for magtape 
operations. 


@e The fourth section contains a table of all valid CSI and KMON options 
for each of the basic BUP operations. 


e The fifth section describes a procedure you can use to transport 
BUP-written magtapes to a VAX/VMS system and manipulate those magtapes. 


The few enhancements that apply to both disk and magtape operations are included 
in both the disk and magtape sections. Therefore, if you are interested in BUP 
enhancements for only disk or magtape operations, you need only read the 
appropriate section. 


You can use the on-line index utility, INDEX, and the on-line help utility, 
HELP, to find more information on topics described in this appendix. 


F.1 NEW OR CHANGED BACKUP COMMAND AND BUP CSI OPTIONS 


BUP supports the following new or changed options. The first column lists the 
BACKUP command option. The second column lists any corresponding BUP CSI 
option. The third column provides an explanation of the option function. 
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Section F.4 shows which options are valid for each type of BUP operation. 


BACKUP 
Command Option 


/ INITIALIZE 


/ [NO] LOG 


/ [NO] QUERY 


/OUTPUT[:filespec] 


/PRINTER 


/ [NO] REWIND 


BUP 
CSI Option* 


/Z 


/W 


Ee 


/M 


Explanation 


Rewinds and initializes magtape output 
volumes. Must be specified to initialize 
a magtape; is automatically included with 
disk operations. 


/NOLOG (/W) suppresses various 
informational messages BUP prints as 
backup operations are performed. The 


default operation is to display the 
messages (/LOG). 


/NOQUERY (/Y) eliminates the need for 
various responses otherwise required from 
the terminal. Allows using BUP from KMON 
command and IND control files to write a 
Single disk or magtape output volume 
(MOUNT prompts require terminal 
response). /QUERY is the default. 


Writes the results of a DIRECTORY/BACKUP 
operation to the specified file. The 
input device can be magtape or disk. The 
default operation (no option or option 
without file specification) displays the 
directory on your terminal. 


Directs the results of a DIRECTORY/BACKUP 
operation to your printer. 


For backup operations, /NOREWIND (/M) 
inhibits rewinding mMagtape before 
appending next saveset to that magtape. 
/NOREWIND increases the speed of backup 
operations but also omits saveset name 
verification (the magtape must rewind to 
check for unique saveset names). 


ees 
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For restore operations, /NOREWIND 
restores the specified saveset from the 
magtape without first rewinding the 


magtape. 


The default operation is to rewind the 
magtape before appending the next saveset 
to the magtape or restoring the specified 
saveset from the magtape (/REWIND). 
Also, some magtape handlers force a 
rewind operation if the handler has not 
been used since it was fetched or loaded. 


/ [NO] SCAN /G /NOSCAN (/G) inhibits the bad-block scan 
on disk output volumes. Use /NOSCAN only 
with disk output volumes you know contain 
no bad blocks. The default operation is 
to scan each device output volume for bad 
blocks (/SCAN). 


/SAVESET /S Valid only with /RESTORE/DEVICE/FILES 
options combination and only from magtape 
volumes. Use to indicate the saveset 
containing a file you want to restore. 


/VERIFY : ONLY /V:ONL Valid only when used with /RESTORE (/X) 
option. Causes a comparison between 
named saveset and restored file Or 
volume. 


* All CSI options are position dependent; they must be coupled with the input 
file. Including any CSI option with the output file returns an error 
message. 


F.2 BUP ENHANCEMENTS FOR DISK OPERATIONS 
The following list describes the BUP enhancements for disk operations: 
@® You can suppress various informational messages that BUP displays as 
backup operations are performed, using the BACKUP /NOLOG option (BUP 
/W) . 


The default operation is to continue to display the messages (/LOG). 


@® You can eliminate the need for various responses otherwise required by 
the terminal, using the BACKUP /NOQUERY option (BUP /Y). The /NOQUERY 
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option lets you run BUP from indirect command and IND control files, 
because you no longer have to respond at the terminal to the first | 
volume mount prompt. (You must still respond at the terminal to any Ww 
prompt to mount the second and subsequent volumes. ) 


The default operation is to require those responses (/QUERY). 


@® You can direct the results of a DIRECTORY/BACKUP operation to a 
specified file, using the /OUTPUT[:filespec] option. 


The default operation (no option or the option without a file 
specification) is to direct output to your terminal. 


e® You can direct the results of a DIRECTORY/BACKUP operation to a printer, 
using the /PRINTER option. 


@ You can inhibit the bad-block scan on disk output volumes, using the 
BACKUP /NOSCAN option (BUP /G). You should not use this option unless 
you have previously verified that a disk contains no bad blocks. 


| 
The default operation is to scan each disk output volume for bad blocks 
(/SCAN) . 
® You can verify that a restored file or volume matches the named backup 
by including the /VERIFY:ONLY option (BUP /V:ONL) with the BACKUP 
/RESTORE option (BUP /X). 
F.3  BUP ENHANCEMENTS FOR MAGTAPE OPERATIONS wy 
Significant enhancements have been added to BUP for making backups to magtapes. 
This section describes those enhancements and is divided into the following 
parts: 
e A summary of the new BUP magtape functionality. 
e A discussion, with examples, of how you use the new BUP magtape 
functionality during the four logical parts of BUP operations: we 
@® Initialize the magtape backup medium 
@ Create the magtape backup 
@ Obtain a directory of the backup magtape volume or series of volumes 
@ Restore files or devices from the magtape volume or series of volumes 
e A discussion, with examples, of how you can transport BUP-written 
magtapes to a VAX processor running VMS. 
wy 


ony 
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F.3.1 Summary of Enhancements for BUP Magtape Operations 


The following list is a summary of the new BUP magtape functionality: 


You can now transport BUP-written magtapes to a VAX/VMS system and 
manipulate those magtapes. This functionality is described in Section 
Fads 


The format that BUP uses to store data on magtape volumes has been 
changed to increase the reliability of multivolume magtape data 
retrieval and to make those volumes abide by certain industry 
conventions. 


BUP detects whether a magtape is organized in the new or old format, 
using information stored in the header records. 


BUP now creates multivolume magtapes containing fixed-length records and 
labels that comply with the ANSI X3.27-1986 and ISO 1001-1986 standards 
for magtape labels. 


You can perform multiple backup operations to the same magtape or series 
of magtapes. Each backup operation creates a saveset on that magtape or 
series of magtapes. You can create a saveset that contains a file or a 
device backup. 


The format of magtape backup directories has been changed to include 
information that applies to the new saveset functionality. 


You can restore a file saveset, a device saveset, or a file located on a 
particular device saveset. 


The following sections describe, with examples, how to perform multiple 
backup operations. 


BUP performs better error checking during magtape operations. 


You can include the /VERIFY:ONL option with restoration operations to 
verify that the output image is the same as the backup image. 


BUP records a starting block number in the header for each magtape 
volume. That starting block number is then checked when the magtape is 
restored during a multivolume magtape restoration operation. 


During certain restore operations, BUP checks that a final tape mark 
follows the last indicated data record to verify the position of 
restored blocks. | 

The enhanced error checking is described in Section F.3.5.4. 


Changes have been made to magtape output volume initialization. Those 
changes are described in Section F.3.2. 


The new BACKUP command option /NOQUERY (BUP /Y) eliminates the need for 


responses from the terminal to initial volume mount prompts and lets you 
run BUP from indirect command files or IND control files. 
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@ Two new options, /OUTPUT:filespec and /PRINTER, let you send the output 
of a directory operation to a specified file or the printer. Those 
options are described in Section F.3.4.2. 


F.3.2 Initializing Magtape Backup Volumes 


All magtapes used as BUP output volumes must be initialized. The initialization 
process rewinds the magtape and writes a volume and header label at the 
beginning of the magtape. 


You must explicitly initialize any magtape volume before or during the first 
backup operation to that magtape. When you back up files or volumes to a series 
of magtapes as part of a single backup operation, BUP implicitly initializes all 
subsequent magtapes in the series. 


Do not initialize any magtape after you have performed the first backup 
operation or you will destroy the data residing on that magtape. 


You can use the INITIALIZE command with the /BACKUP option to initialize a 
magtape volume prior to the first backup operation to that volume. For example, 
the following command initializes magtape device MSO: 


,INITIALIZE/BACKUP MSO: <RET> 


You can also initialize the magtape volume during the first backup operation by 
including the /INITIALIZE option with the BACKUP command line. For example, the 
following command initializes magtape MSO and backs up the device DLJ to MSO. 
The result of this operation is a saveset named FOO.BUP on device MSO. 


.BACKUP/INITIALIZE/DEVICE DL1: MS0:FOO <RET> 


F.3.3 Creating the Magtape Backup Volumes 


You can perform multiple backup operations to the same magtape or series of 
magtapes. The result of each volume or file backup operation is called a 
’saveset’. You can only create savesets on magtapes; you cannot create savesets 
on disks. 


Use the following information to create savesets: 


e You can name each saveset as shown in the following example. Each 
saveset name must be unique, or BUP returns a fatal level error message. 
The following example illustrates backing up the volume located on 
device DL1. In the command, DL1 is the input device, MSO is the backup 
magtape volume, and FOO is the optional saveset name with the default 
file type Of ~BuUr: 


.BACKUP/DEVICE DL1: MS0:FOO <RET> 


If you do not supply a saveset name, BUP uses the device name with file 
type .BUP as that saveset name (DL1.BUP). 
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® You can back up a file that is located on a volume to a sSaveset on 
magtape by including the file name in the command line. For example, 
the following command backs up the file MYFILE.TXT, located on device 
DII, to magtape MSO. Because no explicit saveset name is specified, 
this saveset will have the name MYFILE.BUP. It is assumed that  saveset 
FOO.BUP is already written on magtape MSO; saveset MYFILE.BUP is being 
added to magtape MSO. 


_BACKUP DL1:MYFILE.TXT MSO: <RET> 


BUP notifies you that this saveset is being added to another saveset on 
magtape MSO by displaying the following informational message: 


?BUP-I-Appending to volume 


e BUP normally rewinds magtapes before each backup operation. It “you 
intend to create a number of savesets on a magtape, you can inhibit the 
magtape rewinding by including the /NOREWIND option in the backup 
command line. However, BUP cannot check that the saveset name you use 
is unique, unless the tape rewinds before each backup operation. 
Therefore, DIGITAL recommends you explicitly assign unique saveset names 
when you use the /NOREWIND option. 


® If BUP detects a write-locked magtape volume while writing the first 
record to that volume, BUP prompts you to remount that magtape volume. 
You can then write enable that magtape volume and remount it. This is 
especially helpful when making multivolume backups; when a saveset is 
being written to more than one magtape. 


As before, attempting to write other than the first record to a 
write-locked magtape returns a fatal-level error message. 


F.3.4 Directory Enhancements for Magtape Backup Volumes 


DIGITAL recommends you create and save two directories for each magtape back up 
series. You should create a directory of the files located within each device 
volume before you back up that volume to a saveset. You should also maintain a 
directory of the savesets located on each magtape backup volume in the backup 
series. 


You can restore the first section of a saveset or a file located on a saveset by 
mounting only the backup magtape containing that saveset. A directory of the 
savesets on a series of backup magtapes can point you to the correct magtape to 
mount. A directory of the files on a saveset can point you to the saveset 
containing a file you want to restore. 


Because of the new saveset functionality, BUP must read to the end of magtape 
volumes before returning a directory. For certain magtape devices, this process 
can take some time. 
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F.3.4.1 The Directory Format - The format for BUP magtape directories has been 
changed to include the following new information: 


e The saveset name. 


® The section of that saveset residing on this magtape volume. sine 
saveset is spread across more than one magtape volume, the magtape 
volume containing the first section of the saveset is identified as 
section 1, that containing the second section as section 2, and so on. 


e The size of that saveset in blocks on this magtape volume followed by 
the total size of the saveset. If the two numbers are the same, the 
entire saveset is on this magtape volume. 


@ The date on which that saveset was backed up to this magtape volume. 


The following is an example display of the BUP magtape directory. The example 
magtape backup volume contains the second section (2348 blocks) of a 5400-block 
saveset named BIGDSK.BUP, the complete savesets FIRST.TXT and SECOND.BUP, and 
the first (408-block) section of a 988-block saveset THIRD.BUP. 


SAVESET SECTION BLOCKS DATE 
BIGDSK.BUP 2 2348/5400 20-MAR-87 
FIRS? , TXT 1 800/800 20-MAR-87 
SECOND . BUP i 5400/5400 21-MAR-87 
THIRD .BUP 1 408/988 26-MAR-87 


You would need to mount a previous magtape in this series to restore the saveset 
BIGDSK.BUP, because the first section of that saveset is not located on this 
volume. The directory of savesets for each magtape backup volume that DIGITAL 
recommends you maintain would direct you to the correct volume to mount. You 
could restore the savesets FIRST.TXT and SECOND.BUP from this volume. You would 
proceed to the next magtape volume of this series to restore the second section 
Of THLED.BUP. 


F.3.4.2 The Directory Destination - You can send a magtape backup volume 
directory to your terminal, a specified output file, or your printer. 


You can display a directory of the savesets residing on a specified magtape to 
your terminal with the DIRECTORY/BACKUP command. The following example displays 
the directory of savesets for magtape MSO: 


. DIRECTORY/BACKUP MSO: <RET> 
You can send the directory of the savesets on a magtape to the device and file 
you specify by appending the /OUTPUT[:filespec] option. The default file type 
is .LST. For example, the following command stores the directory of magtape MSO 
on device DLJ with the file name MAG1.LST: 


. DIRECTORY/BACKUP/OUTPUT:DL1:MAG1 MSO: <RET> 
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You can send the directory of the savesets on a magtape to your printer by 
appending the /PRINTER option. The following example sends a directory of the 
Ssavesets on magtape MSO to your printer: 


DIRECTORY/BACKUP/PRINTER MSO: <RET> 


F.3.5 Restoring Savesets from Magtape Backup Volumes 


From a magtape backup volume, you can restore a device image saveset, a file 
image saveset, or a file image residing on a device image saveset. 


F.3.5.1 Restoring a Device Image Saveset - You restore a device image saveset 
from a magtape or series of magtapes, using the following command. Because you 
are performing a device restoration to a disk, BUP initializes that disk as part 
of the operation. In the command, FOO is the named saveset contained on magtape 
MSO. You are restoring FOO to disk device DLI1: 


.BACKUP/RESTORE/DEVICE MSO:FOO DL1: <RET> 


F.3.5.2 Restoring a File Image Saveset - You restore a file image saveset from 
a magtape or series of magtapes by excluding the /DEVICE option. Because you 
are performing a file restoration to a disk, BUP does not initialize that disk 
as part of the operation. The following command restores the file image 
FIRST.TXT from magtape MSO to device DLI1: 


.BACKUP/RESTORE MSO:FIRST.TXT DL1: <RET> 


If you do not specify a file name, BUP restores the first saveset on the magtape 
and uses that saveset name as the destination file name. 


F.3.5.3 Restoring a File Image Located Within a Device Saveset - You restore a 
file located within a device image saveset, using the /SAVESET option with the 
RESTORE/DEVICE/FILES option combination. Because you are performing a file 
restoration to a disk, BUP does not initialize that disk as part of the 
operation. In the command line, you couple the /SAVESET option with the saveset 
name and supply the file name. 


The following example restores the file, FILE.TXT, located within saveset 
FOO.BUP contained on magtape MS0. This example assumes that magtape MSO 
contains the entire file; if not, you would be prompted to mount the next 
Magtape input volume. 
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, BACKUP /RESTORE/DEVICE/FILE MS0:FOO/SAVESET,FILE.TXT DL1: <RET> 
Mount input volume 1 in MSO: Continue? Y <RET> 

?BUP-I-Restore operation started on volume 1 

?BUP-I-Copy operation is complete 


If you do not specify the saveset name in the command line, BUP attempts to 
restore the specified file from the first saveset encountered on the magtape. 


F.3.5.4 Enhancements to Error Checking During Restoration - BUP includes the 
following enhancements for better error checking during restoration operations. 


BUP supports the /VERIFY:ONL option that lets you verify that the 
contents of a device or file image are the same as the contents of the 
saveset. You must couple the /VERIFY:ONL option with the /RESTORE 
option. 


In the following example command, the contents of saveset fF0O0O.BUP, 
located on magtape volume MSO, are restored to disk DZJ. Error checking 
1s performed: 

, BACKUP/RESTORE/DEVICE/VERIFY:ONL MSO:FOO DL1: <RET> 


BUP records a starting block number in the header of each saveset 


section. The value for that starting block number is the value for any 
previous starting block number plus the number of blocks on the previous 
Saveset. During a multivolume /RESTORE operation, each starting block 
number is checked for consistency against the expected starting block 
number. If the two numbers disagree, the following error and warning 


messages are displayed: 


?BUP-E-Tape volume position error 
?BUP-W-Expected block nnn; Tape volume begins with mmm 


When the starting block numbers disagree by 16 or less, the /RESTORE 
operation resumes with the current magtape starting block number. BUP 
displays the following warning message: 


?BUP-W-Continuing RESTORE with mounted volume 
BUP aborts when the starting block numbers disagree by more than 16. 


BUP performs a new consistency check at the end of each /DEVICE or file 
/RESTORE operation (but not /DEVICE/FILES). BUP reads the record 
following the last data record to verify that it is the final tape mark. 
If the final tape mark is not found, the RESTORE operation probably did 
not store blocks in their correct locations. BUP then displays the 
following error message: 


?BUP-E-Tape volume position error 
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F.4 VALID BUP OPTIONS FOR EACH TYPE OF OPERATION 


BUP operations involve either initialization, making the backup, obtaining a 
directory, or restoring what was backed up. The following table lists valid BUP 
option (KMON and CSI) combinations for those categories of BUP operations: 


Valid Valid 

CSI KMON 
Operation Options Options 
Initialize. 72 FINTTIALIZ:S 

}Y /NOQUERY 
Backup rt /DEVICE 

jz / INITIALIZE 

/W /NOLOG 

/Y /NOQUERY 

/M /NOREWIND 

/G /NOSCAN 

/V /VERIFY 
Directory /L DIRECTORY / BACKUP 


DIRECTORY/BACKUP/OUTPUT[:filespec] 
DIRECTORY/BACKUP/PRINTER 


Restore ‘s /RESTORE 
/F /FILE 
/I /DEVICE 
/W /NOLOG 
1% /NOQUERY 
/M /NOREWIND 
/S /SAVESET 


/V{:ONL] /VERIFY[:ONLY] 


F.5 TRANSPORTING BUP-WRITTEN MAGTAPES TO VAX/VMS 


You can transport BUP-written magtapes to a VAX/VMS system and extract files 
from those magtapes. Magtapes you transport should be created using the /DEVICE 
option, so they contain directory-structured logical or physical disk images. 
Use the following procedure: 


1. Back up an RT-11 device image to a magtape. The following example 
command backs up the device image LD3 to magtape Mdn and assigns the 
saveset name MYDISK to that backup image: 


,BACKUP/DEVICE LD3: Mdn:MYDISK <RET> 


2. Mount that backup magtape on a VAX/VMS system. All magtapes created by 
BUP have the volume label, RTBUP. Therefore, use the following 
command, where mddn represents the magtape drive, RTBUP is the volume 
label, and TAPE is the logical name: 


S$ MOUNT mddn: RTBUP TAPE <RET> 
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Copy the BUP backup image to disk, using the following command, where 


MYDISK is saveset name for the RT-11 device you backed up. 
command produces a virtual disk image file: 


§ COPY mddn:MYDISK.BUP * <RET> 


Use the VAX/VMS EXCHANGE utility or RTEM to manipulate files on that 
virtual disk file. See the VAX/VMS EXCHANGE utility documentation for 


information on using EXCHANGE. The following command is shown as 
example. In the example, vdn is a virtual disk name: 


$ EXCHANGE <RET> 
EXCHANGE>MOUNT/VIRTUAL vdn: MYDISK.BUP <RET> 
EXCHANGE>DIR vdn: <RET> 
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